Multimodal Reference-to-Video

Generate one target video from reference images (0–9) + videos (0–3) + audio (0–3) + optional text. Supports creating new videos, editing, and extending.

Note: Audio alone is not allowed; include at least one reference video or image.

Optional synchronized audio. Up to 15 seconds and 4K resolution (standard model).

This is an async task-based API: submit a request to receive a task id, poll for status, then download the video when complete.

Only Doubao Seedance 2.0 series models are supported.

Note: First frame, first & last frames, and multimodal reference-to-video are mutually exclusive. You can prompt the model to treat a reference image as the first/last frame; for strict frame matching, prefer Image-to-Video.

Base URL

• https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) Authenticate using a Bearer Token. Format: Authorization: Bearer sk-xxxxxx

Endpoints

POST /api/v3/contents/generations/tasks

Create Video Generation Task

Create a video generation task from multimodal reference assets.

Request Body

Content-Type: application/json

Example:

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "Extend this clip so the cat walks out of frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/ref-cat.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/cat-original.mp4"
      },
      "role": "reference_video"
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

Properties:

Allowed combinations (text always optional): images only; video only; image+audio; image+video; video+audio; image+video+audio. Audio alone is not allowed.

Seedance 2.0 does not accept reference images/videos containing real human faces uploaded directly. Use preset virtual avatars, authorized real-person assets, or face-containing outputs generated by Seedance 2.0 under your account within the last 30 days.

{
  "tools": [
    { "type": "web_search" }
  ]
}

Responses

200: Task created successfully

Content-Type: application/json

400: Invalid request parameters

Content-Type: application/json

429: Rate limited

Content-Type: application/json

Request examples

curl -X POST "https://api.autorouter.top/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "Extend this clip so the cat walks out of frame"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/cat-original.mp4"
      },
      "role": "reference_video"
    }
  ],
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}'

Response examples

{
  "id": "cgt-2025xxxxxx-xxxxx"
}

Response fields:

GET /api/v3/contents/generations/tasks/{id}

Get Video Generation Task

Query the status and result of a video generation task.

• Only the last 7 days of task records are queryable, in the interval [T-7 days, T), where T is the request UTC timestamp (second precision)
• Video URLs are valid for 24 hours; download or transfer them promptly

Headers

Path Parameters

Responses

200: Query succeeded

Content-Type: application/json

Request examples

curl -X GET "https://api.autorouter.top/api/v3/contents/generations/tasks/{id}" \
  -H "Authorization: Bearer sk-xxxxxx"

Response examples

{
  "id": "cgt-2025xxxxxx-xxxxx",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "error": null,
  "created_at": 1730000000,
  "updated_at": 1730000060,
  "content": {
    "video_url": "https://ark-video-xxx.volces.com/xxx.mp4",
    "last_frame_url": "https://ark-video-xxx.volces.com/xxx.png"
  },
  "seed": -1,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "tools": [
    { "type": "web_search" }
  ],
  "safety_identifier": "user_hash_xxx",
  "priority": 0,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "usage": {
    "completion_tokens": 108000,
    "total_tokens": 108000,
    "tool_usage": {
      "web_search": 1
    }
  }
}

Response fields:

Error handling

HTTP 400

HTTP 401 / 403

• 401 Unauthorized: Invalid or expired API Key
• 403 Forbidden: API Key not allowed for this model

HTTP 402

Insufficient balance. Top up in the AutoRouter console.

Task failed / expired

Failed tasks are automatically refunded.