Seedance 2.0多模态参考生视频API-豆包AI-AutoRouter

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "延长这段视频，让猫咪走到画面外"
    },
    {
      "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:

Name	Type	Required	Description
`model`	string	Yes	模型 ID。可选值见下方说明
`content`	object[]	Yes	输入内容列表，支持文本、图片、视频、音频
`content[].type`	string	Yes	内容类型：`text` / `image_url` / `video_url` / `audio_url`
`content[].text`	string	No	文本提示词（`type=text` 时）
`content[].image_url.url`	string	Yes*	参考图 URL / Base64 / 素材 ID（`type=image_url` 时）
`content[].video_url.url`	string	Yes*	参考视频 URL / 素材 ID（`type=video_url` 时）
`content[].audio_url.url`	string	Yes*	参考音频 URL / Base64 / 素材 ID（`type=audio_url` 时）
`content[].role`	string	Yes*	媒体用途：`reference_image` / `reference_video` / `reference_audio`
`resolution`	string	No	视频分辨率。详见下方说明
`ratio`	string	No	视频宽高比。默认 `adaptive`
`duration`	integer	No	视频时长（秒）。取值 `[4, 15]` 或 `-1`，默认 `5`
`generate_audio`	boolean	No	是否生成有声视频。默认 `true`
`watermark`	boolean	No	是否添加「AI 生成」水印。默认 `false`
`callback_url`	string	No	任务状态变化时的回调通知地址
`return_last_frame`	boolean	No	是否返回生成视频的尾帧图像。默认 `false`
`execution_expires_after`	integer	No	任务超时阈值（秒），取值 `[3600, 259200]`，默认 `172800`
`priority`	integer	No	执行优先级，取值 `[0, 9]`，默认 `0`
`tools`	object[]	No	工具配置，如联网搜索
`safety_identifier`	string	No	终端用户唯一标识（英文，≤64 字符）

支持的内容组合（文本均可选）：纯图片；纯视频；图片+音频；图片+视频；视频+音频；图片+视频+音频。不可单独输入音频。

Seedance 2.0 系列不支持直接上传含有真人人脸的参考图 / 视频。可使用平台预置虚拟人像、已授权真人素材，或本账号近 30 天内由 Seedance 2.0 生成的含人脸原始产物。

modelstring（必选）

您需要调用的模型 ID。

模型	说明	默认分辨率	可选分辨率
`doubao-seedance-2-0-260128`	标准版，画质优先	`720p`	`480p`、`720p`、`1080p`、`4k`
`doubao-seedance-2-0-fast-260128`	快速版，延迟更低	`720p`	`480p`、`720p`
`doubao-seedance-2-0-mini-260615`	轻量版	`720p`	`480p`、`720p`

contentobject[]（必选）

输入给模型生成视频的信息，支持文本、图片、音频、视频。

typestring（必选）

内容类型：text、image_url、video_url、audio_url。

textstring（可选）

文本提示词。

语言支持： 中英文；额外支持西班牙语、印度尼西亚语、葡萄牙语、日语
字数建议： 中文不超过 500 字，英文不超过 1000 词

image_url.urlstring（可选）

参考图片来源：公网 URL、Base64（data:image/<格式>;base64,...）或素材 ID（asset://<ASSET_ID>）。

单张图片要求：

格式： jpeg、png、webp、bmp、tiff、gif、heic、heif
宽高比： [0.4, 2.5]
宽高长度： [300, 6000] px
大小： 单张小于 30 MB；请求体不超过 64 MB
数量： 1–9 张

role 必填，固定为 reference_image。

video_url.urlstring（可选）

参考视频来源：公网 URL 或素材 ID（asset://<ASSET_ID>）。

单个视频要求：

格式： mp4、mov（H.264/AVC、H.265/HEVC；音频 AAC、MP3）
分辨率： 480p、720p、1080p、4k
时长： 单个 [2, 15] s；最多 3 个参考视频；所有视频总时长不超过 15 s
宽高比： [0.4, 2.5]；宽高长度 [300, 6000] px
总像素： [409600, 8295044]
大小： 单个不超过 200 MB
帧率： [24, 60] FPS

role 必填，固定为 reference_video。

audio_url.urlstring（可选）

参考音频来源：公网 URL、Base64（data:audio/<格式>;base64,...）或素材 ID（asset://<ASSET_ID>）。

单个音频要求：

格式： wav、mp3
时长： 单个 [2, 15] s；最多 3 段；所有音频总时长不超过 15 s
大小： 单个不超过 15 MB；请求体不超过 64 MB。大文件请勿使用 Base64

role 必填，固定为 reference_audio。

注意：不可单独输入音频，应至少包含 1 个参考视频或图片。

resolutionstring（可选）

视频分辨率。

doubao-seedance-2-0-260128：默认 720p；可选 480p、720p、1080p、4k
doubao-seedance-2-0-fast-260128 / doubao-seedance-2-0-mini-260615：默认 720p；可选 480p、720p

ratiostring（可选）

生成视频的宽高比例。默认 adaptive。

可选值：16:9、4:3、1:1、3:4、9:16、21:9、adaptive

adaptive 适配规则：

视频延长 / 视频编辑： 根据首个被延长 / 待编辑视频的宽高，映射到最接近的固定枚举值
参考生视频： 以传入的第一个媒体文件为准（优先级：视频＞图片），映射到最接近的固定枚举值

不同分辨率对应的宽高像素值：

分辨率	16:9	4:3	1:1	3:4	9:16	21:9
480p	864×496	752×560	640×640	560×752	496×864	992×432
720p	1280×720	1112×834	960×960	834×1112	720×1280	1470×630
1080p	1920×1080	1664×1248	1440×1440	1248×1664	1080×1920	2206×946
4k	3840×2160	3326×2494	2880×2880	2494×3326	2160×3840	4398×1886

durationinteger（可选）

生成视频时长（单位：秒）。默认 5，取值范围 [4, 15] 或 -1。

duration = -1 时，模型在有效取值范围内自主选择合适的整数秒时长。

generate_audioboolean（可选）

控制生成的视频是否包含与画面同步的声音。默认 true。

true：输出有声视频
false：输出无声视频

注意：生成的有声视频均为单声道，与传入的音频声道数无关。

toolsobject[]（可选）

配置模型要调用的工具。当前支持 web_search（联网搜索）。

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

实际搜索次数可通过查询任务 API 返回的 usage.tool_usage.web_search 获取。

Responses

200: 成功创建任务

Content-Type: application/json

400: 请求参数错误

Content-Type: application/json

429: 请求频率限制

Content-Type: application/json

请求示例

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": "延长这段视频，让猫咪走到画面外"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/cat-original.mp4"
      },
      "role": "reference_video"
    }
  ],
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}'

响应示例

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

响应字段说明：

Name	Type	Description
`id`	string	视频生成任务 ID。仅保存 7 天。创建为异步接口，需通过查询任务 API 获取结果

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

查询视频生成任务

查询视频生成任务的状态与结果。

仅支持查询最近 7 天的任务记录，时间区间为 [T-7天, T)，其中 T 为请求发起时刻的 UTC 时间戳（精确到秒）
视频 URL 有效期为 24 小时，请及时下载或转存

Headers

Name	Type	Required	Description
`Authorization`	string	Yes	请求身份认证。格式：`Bearer sk-xxxxxx`

Path Parameters

Name	Type	Required	Description
`id`	string	Yes	您需要查询的视频生成任务 ID

Responses

200: 成功查询任务

Content-Type: application/json

请求示例

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

响应示例

{
  "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
    }
  }
}

响应字段说明：

Name	Type	Description
`id`	string	视频生成任务 ID
`model`	string	任务使用的模型名称和版本，格式为 `模型名称-版本`
`status`	string	任务状态，见下方说明
`error`	object / null	错误信息；成功时为 `null`，失败时返回错误数据
`created_at`	integer	任务创建时间的 Unix 时间戳（秒）
`updated_at`	integer	任务当前状态更新时间的 Unix 时间戳（秒）
`content`	object	视频生成任务的输出内容
`content.video_url`	string	生成视频的 URL，格式为 mp4。有效期 24 小时
`content.last_frame_url`	string	视频尾帧图像 URL。有效期 24 小时。仅创建时设置 `"return_last_frame": true` 时返回
`seed`	integer	本次请求使用的种子整数值
`resolution`	string	生成视频的分辨率
`ratio`	string	生成视频的宽高比
`duration`	integer	生成视频的时长（秒）。与 `frames` 只会返回其中一个；创建时未指定 `frames` 时返回本字段
`frames`	integer	生成视频的帧数。与 `duration` 只会返回其中一个；创建时指定了 `frames` 时返回本字段
`framespersecond`	integer	生成视频的帧率
`generate_audio`	boolean	生成的视频是否包含与画面同步的声音。Seedance 2.0 系列会返回
`tools`	object[]	本次请求模型实际使用的工具。未使用工具时不返回
`tools[].type`	string	实际使用的工具类型，如 `web_search`
`safety_identifier`	string	终端用户唯一标识符。创建时设置了该参数才会原样返回
`priority`	integer	当前请求的执行优先级
`service_tier`	string	实际处理任务使用的服务等级
`execution_expires_after`	integer	任务超时阈值，单位：秒
`usage`	object	本次请求的 token 用量
`usage.completion_tokens`	integer	模型生成视频消耗的 token 数量，可作为计费对账依据
`usage.total_tokens`	integer	本次请求消耗的总 token 数量。视频生成不统计输入 token，故 `total_tokens` = `completion_tokens`
`usage.tool_usage`	object	使用工具的用量信息
`usage.tool_usage.web_search`	integer	实际调用联网搜索工具的次数，仅开启联网搜索时返回

statusstring

任务状态：

queued：排队中
running：任务运行中
cancelled：任务已取消（取消状态 24h 后自动删除；仅支持取消排队中的任务）
succeeded：任务成功
failed：任务失败
expired：任务超时

建议轮询间隔 3～5 秒，直到 status 为 succeeded、failed、cancelled 或 expired。

errorobject / null

错误提示信息。任务成功返回 null，任务失败时返回错误数据。

codestring

错误码。

messagestring

错误提示信息。

contentobject

视频生成任务的输出内容。

video_urlstring

生成视频的 URL，格式为 mp4。有效期为 24 小时，请及时下载或转存。

last_frame_urlstring

视频的尾帧图像 URL。有效期为 24 小时，请及时下载或转存。

仅创建任务时设置 "return_last_frame": true 时返回。

generate_audioboolean

生成的视频是否包含与画面同步的声音。Seedance 2.0 系列会返回该参数。

true：模型输出的视频包含同步音频
false：模型输出的视频为无声视频

usageobject

本次请求的 token 用量。

completion_tokensinteger

模型生成视频消耗的 token 数量，可作为计费对账依据。

说明：Seedance 2.0 系列模型存在最低 token 用量限制。如果实际 token 用量小于最低用量，本字段会返回最低 token 用量，平台按最低用量计费。

total_tokensinteger

本次请求消耗的总 token 数量。视频生成模型不统计输入 token（为 0），故 total_tokens = completion_tokens。

tool_usageobject

使用工具的用量信息。

web_search（integer）：实际调用联网搜索工具的次数，仅开启联网搜索时返回

错误处理

HTTP 400 参数错误

场景	处理建议
仅传音频、无图片/视频	至少包含 1 个参考视频或图片
`role` 未填或填错	参考图 / 视频 / 音频须分别为 `reference_image` / `reference_video` / `reference_audio`
与首帧 / 首尾帧场景混用	三种场景互斥，不可混用
参考视频 / 音频超数量或总时长	视频最多 3 个、音频最多 3 段，各自总时长 ≤ 15 s
Fast / Mini 使用 `1080p` 或 `4k`	改用 `480p` / `720p`，或切换标准版模型

HTTP 401 / 403 鉴权错误

401 Unauthorized：API Key 无效或已过期
403 Forbidden：API Key 无权访问此模型

HTTP 402 余额不足

返回余额不足错误。请前往 AutoRouter 控制台充值。

任务 `failed` / `expired` 状态

原因	处理建议
内容审核失败	调整提示词或更换参考素材
媒体 URL 不可访问	确保公网可访问，或改用 Base64 / 素材 ID
含未授权真人人脸	使用虚拟人像、已授权素材或本账号近期生成的产物
任务超时	通过 `execution_expires_after` 调整后重试

任务失败时 AutoRouter 会自动退款到你的账户。

多模态参考生视频

modelstring（必选）

contentobject[]（必选）

属性

resolutionstring（可选）

ratiostring（可选）

durationinteger（可选）

generate_audioboolean（可选）

toolsobject[]（可选）

statusstring

errorobject / null

属性

contentobject

属性

generate_audioboolean

usageobject

属性

目录