Seedance 2.5视频生成API-豆包AI-AutoRouter

通过文本、图片、视频、音频等多模态输入生成有声/无声视频。异步任务接口，提交后返回任务 ID，需轮询任务状态获取结果。

通过 Doubao Seedance 2.5 生成 1 个目标视频，支持有声 / 无声输出。最长 30 秒，分辨率 480p / 720p。支持以下场景：

文生视频：输入文本提示词生成 1 个目标视频
图生视频-首帧：输入 1 张首帧图片 + 文本提示词（可选）
图生视频-首尾帧：输入首帧图片 + 尾帧图片 + 文本提示词（可选）
全模态参考生视频：输入参考图片（0–30 张）+ 参考视频（0–10 个）+ 参考音频（0–10 个）+ 文本提示词（可选）。支持仅传入音频。支持生成全新视频、编辑视频、延长视频，支持 30 秒视频连贯直出

异步任务型接口：提交后立即返回任务 id，需轮询任务状态，成功后再下载视频。

仅支持 Doubao Seedance 2.5 模型（doubao-seedance-2-5-260628）。

注意：图生视频-首帧、图生视频-首尾帧、全模态参考生视频 为 3 种互斥场景，不可混用。全模态参考可通过提示词指定参考图片作为首帧 / 尾帧；若需严格保障首尾帧一致，优先使用图生视频-首尾帧。

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Endpoints

POST `/api/v3/contents/generations/tasks`

创建视频生成任务

通过文本、图片、视频、音频创建视频生成任务。

Request Body

Content-Type: application/json

Example（文生视频）：

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "小猫对着镜头打哈欠"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

Example（图生视频-首帧）：

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "让这只猫跳起来"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/cat.jpg"
      },
      "role": "first_frame"
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 5,
  "generate_audio": true
}

Example（全模态参考生视频）：

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "延长这段视频，让猫咪走到画面外"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/cat-original.mp4"
      },
      "role": "reference_video"
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": -1,
  "omni_reference_task_type": "extend",
  "generate_audio": true
}

Properties:

Name	Type	Required	Description
`model`	string	Yes	模型 ID。固定为 `doubao-seedance-2-5-260628`
`content`	object[]	Yes	输入内容列表，支持文本、图片、视频、音频
`content[].type`	string	Yes	内容类型：`text` / `image_url` / `video_url` / `audio_url`
`content[].text`	string	Yes*	文本提示词（`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	视场景	媒体用途，见下方说明
`resolution`	string	No	视频分辨率。默认 `720p`，可选 `480p`、`720p`
`ratio`	string	No	视频宽高比。默认 `adaptive`。详见下方说明
`duration`	integer	No	视频时长（秒）。取值 `[4, 30]` 或 `-1`，默认 `-1`
`generate_audio`	boolean	No	是否生成有声视频。`true`（默认）有声，`false` 无声
`omni_reference_task_type`	string	No	全模态参考生视频的任务类型引导。默认 `auto`
`output_format`	string	No	输出视频格式。默认 `mp4`，可选 `mp4`、`mov`
`watermark`	boolean	No	是否添加「AI 生成」水印。`false`（默认）不添加，`true` 添加
`callback_url`	string	No	任务状态变化时的回调通知地址
`return_last_frame`	boolean	No	是否返回生成视频的尾帧图像。默认 `false`
`execution_expires_after`	integer	No	任务超时阈值（秒），取值 `[3600, 259200]`，默认 `172800`（48 小时）
`priority`	integer	No	执行优先级，取值 `[0, 9]`，默认 `0`。数值越大优先级越高
`tools`	object[]	No	工具配置，如联网搜索。详见下方说明
`safety_identifier`	string	No	终端用户唯一标识（英文，≤64 字符），用于安全审计

说明：resolution、ratio、duration、watermark 除可在 request body 中直接传入外，也支持在文本提示词后追加 --[parameters] 弱校验传参（如 --rs 720p --rt 16:9 --dur 5 --wm false）。推荐使用 request body 强校验方式。

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

modelstring（必选）

您需要调用的模型 ID。

模型	说明	默认分辨率	可选分辨率
`doubao-seedance-2-5-260628`	Seedance 2.5，支持文生 / 图生 / 全模态参考，最长 30 秒	`720p`	`480p`、`720p`

contentobject[]（必选）

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

支持以下组合（文本均可选，文生视频除外）：纯文本；文本 + 图片；文本 + 视频；文本 + 音频（可仅传音频）；文本 + 图片 + 音频；文本 + 图片 + 视频；文本 + 视频 + 音频；文本 + 图片 + 视频 + 音频。

typestring（必选）

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

textstring（视场景）

文本提示词，描述期望生成的视频。文生视频必填；图生视频与全模态参考场景下可选。

语言支持： 中英文；额外支持西班牙语、印度尼西亚语、葡萄牙语、日语、马来语、泰语、阿拉伯语、越南语、韩语
字数建议： 中文不超过 500 字，英文不超过 1000 词。字数过多易导致信息分散
生成有声视频时，建议将对话部分置于双引号内，例如：男人叫住女人说："你记住，以后不可以用手指指月亮。"

示例值：小猫对着镜头打哈欠

image_url.urlstring（视场景）

图片来源，支持：

公网 URL：图片的公网可访问地址
Base64：data:image/<格式>;base64,<编码>，格式需小写，如 data:image/png;base64,...
素材 ID：asset://<ASSET_ID>（预置素材 / 虚拟人像）

单张图片要求：

格式： jpeg、png、webp、bmp、tiff、gif、heic、heif
宽高比（宽/高）： [0.4, 2.5]
宽高长度： [300, 6000] px
大小： 单张小于 30 MB；请求体不超过 64 MB。大文件请勿使用 Base64

图片数量：

图生视频-首帧：1 张
图生视频-首尾帧：2 张
全模态参考生视频：1–30 张

video_url.urlstring（视场景）

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

单个视频要求：

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

audio_url.urlstring（视场景）

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

单个音频要求：

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

Seedance 2.5 可仅传入音频，无需搭配图片 / 视频；也可配合图片 / 视频一起传入。

rolestring（视场景）

媒体的位置或用途。

图生视频-首帧

传入 1 个 image_url 对象，role 为 first_frame 或不填。

图生视频-首尾帧

传入 2 个 image_url 对象，且 role 必填：

首帧：first_frame
尾帧：last_frame

说明：首尾帧图片可相同。宽高比不一致时以首帧为主，尾帧会自动裁剪适配。

全模态参考生视频

参考图：role 必填，固定为 reference_image
参考视频：role 固定为 reference_video
参考音频：role 固定为 reference_audio

注意：图生视频-首帧、图生视频-首尾帧、全模态参考生视频为 3 种互斥场景，不可混用。

resolutionstring（可选）

视频分辨率。默认 720p；可选 480p、720p。

Seedance 2.5 暂不支持 1080p、4k。

ratiostring（可选）

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

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

注意：Seedance 2.5 模型在 视频编辑、视频延长、首帧 / 首尾帧生视频任务（详见任务类型与判定条件）的限制条件：仅支持配置 ratio 为 adaptive，不支持指定具体宽高比。

不同任务类型的取值限制：

任务类型	规则
文生视频	可指定宽高比，或由模型根据 prompt 自动选择（支持 `adaptive`）
图生视频-首帧 / 首尾帧	自动保持与首帧图片宽高比一致，仅支持 `adaptive`
全模态-参考生视频	可指定宽高比，或由模型自动选择（支持 `adaptive`）
全模态-视频编辑 / 视频延长	自动保持与待编辑 / 待延长视频宽高比一致，仅支持 `adaptive`

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

分辨率	16:9	4:3	1:1	3:4	9:16	21:9
480p	854×480	752×560	640×640	560×752	480×854	992×432
720p	1280×720	1112×834	960×960	834×1112	720×1280	1470×630

图生视频选择的宽高比与上传图片不一致时，平台会居中裁剪。

durationinteger（可选）

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

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

视频编辑任务限制：

仅支持配置 duration 为 -1，不支持指定具体输出时长
传入的待编辑视频时长需在 [4, 30] s 内，否则将触发报错
输出时长与输入视频基本一致（可能略短，误差约 0.4 秒）

通过查询接口返回的 duration 为生成视频时长的约数（整数秒，向下取整）：返回 duration = 实际总帧数 / 24。

generate_audioboolean（可选）

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

true：输出有声视频，模型基于提示词与视觉内容自动生成匹配的人声、音效及背景音乐
false：输出无声视频

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

omni_reference_task_typestring（可选）

全模态参考生视频的任务类型引导，用于提前校验对应限制。默认 auto。

auto：由模型根据输入素材和提示词自动判定任务类型。若参数与实际任务类型不兼容，任务将异步报错（InvalidParameter.TaskTypeConstraint）
reference：参考生视频，基于参考图片、参考视频或参考音频生成新视频。ratio / duration 无特殊限制
edit：视频编辑，对原视频的画面或音频进行编辑。content 中必须至少包含一个 reference_video，且视频时长必须为 4–30 秒；ratio 必须为 adaptive；duration 必须为 -1
extend：视频延长，对原视频向前或向后延长。content 中必须至少包含一个 reference_video；ratio 必须为 adaptive

注意：实际处理时模型仍会结合提示词判断任务类型。若实际判定与指定不一致，仍会异步报错（InvalidParameter.TaskTypeMismatch）。建议按各任务类型的提示词写法传参，降低报错概率。

本参数仅在全模态参考生视频场景下生效。

output_formatstring（可选）

输出视频的格式。默认 mp4。

mp4：通用格式，兼容性最好，采用标准色彩精度，可在网页、移动端、各类播放器及分发平台直接播放
mov：面向专业场景的高色彩精度格式（H.264 + yuv444p + PCM），更好地保持画面色彩与亮度一致性，适用于调色、抠像、合成等后期加工。推荐在视频编辑、视频延长场景使用 mov 作为输入和输出

注意：部分播放器可能不兼容 mov。常见支持播放器：IINA（macOS）、VLC、mpv、ffplay。

toolsobject[]（可选）

配置模型要调用的工具。

typestring（必选）

工具类型。当前支持 web_search（联网搜索）。开启后模型会根据提示词自主判断是否搜索互联网内容，可提升时效性，但会增加一定时延。

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

示例：

{
  "tools": [
    { "type": "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-5-260628",
  "content": [
    {
      "type": "text",
      "text": "小猫对着镜头打哈欠"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}'

响应示例

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

响应字段说明：

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

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

查询视频生成任务

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

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

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-5-260628",
  "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,
  "output_format": "mp4",
  "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。有效期 24 小时，下载次数上限 100 次
`content.last_frame_url`	string	视频尾帧图像 URL。有效期 24 小时，下载次数上限 100 次。仅创建时设置 `"return_last_frame": true` 时返回
`seed`	integer	本次请求使用的种子整数值
`resolution`	string	生成视频的分辨率
`ratio`	string	生成视频的宽高比
`duration`	integer	生成视频的时长（秒）
`framespersecond`	integer	生成视频的帧率
`generate_audio`	boolean	生成的视频是否包含与画面同步的声音
`output_format`	string	实际生成视频的格式（`mp4` 或 `mov`）
`tools`	object[]	本次请求模型实际使用的工具。未使用工具时不返回
`tools[].type`	string	实际使用的工具类型，如 `web_search`
`safety_identifier`	string	终端用户唯一标识符。创建时设置了该参数才会原样返回
`priority`	integer	当前任务的执行优先级，由系统根据账户与模型策略分配。值越大越优先
`service_tier`	string	实际处理任务使用的服务等级
`execution_expires_after`	integer	任务提交后的过期时间（秒）。超时未完成会标记为 `expired`
`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，任务失败时返回错误数据。

说明：Seedance 2.5 在特定任务类型中，需排队等待到任务被消费时，才会返回报错信息。

codestring

错误码。

messagestring

错误提示信息。

contentobject

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

video_urlstring

生成视频的 URL。有效期为 24 小时，下载次数上限为 100 次，请及时下载或转存。

last_frame_urlstring

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

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

generate_audioboolean

生成的视频是否包含与画面同步的声音。

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

output_formatstring

实际生成视频的格式。

mp4：通用格式
mov：专业后期格式

usageobject

本次请求的 token 用量。

completion_tokensinteger

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

total_tokensinteger

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

tool_usageobject

使用工具的用量信息。

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

错误处理

HTTP 400 参数错误

场景	处理建议
未传 `content` / `model`	补全必填字段
未知模型名	使用 `doubao-seedance-2-5-260628`
使用 `1080p` 或 `4k`	Seedance 2.5 仅支持 `480p`、`720p`
首帧 / 首尾帧 / 参考生视频混用	三种场景互斥，不可混用
首帧 / 首尾帧 / 编辑 / 延长指定了非 `adaptive` 的 `ratio`	改为 `adaptive`
视频编辑指定了具体 `duration`	编辑任务仅支持 `duration = -1`
参考视频 / 音频超数量或总时长	视频最多 10 个、音频最多 10 段，各自总时长 ≤ 30 s
`omni_reference_task_type` 与素材 / 提示词不匹配	按任务类型补齐 `reference_video` 等约束，或改用 `auto`

HTTP 401 / 403 鉴权错误

401 Unauthorized：API Key 无效或已过期
403 Forbidden：API Key 无权访问此模型（检查 token 的模型白名单）

HTTP 402 余额不足

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

任务 `failed` / `expired` 状态

原因	处理建议
内容审核失败	调整提示词或更换参考素材
媒体 URL 不可访问	确保公网可访问，或改用 Base64 / 素材 ID
含未授权真人人脸	使用虚拟人像、已授权素材或本账号近期生成的产物
任务类型约束不满足	检查 `ratio`、`duration`、参考视频时长是否符合对应任务类型
任务超时	通过 `execution_expires_after` 调整超时阈值后重试

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

Seedance 2.5 260628 视频生成

modelstring（必选）

contentobject[]（必选）

属性

resolutionstring（可选）

ratiostring（可选）

durationinteger（可选）

generate_audioboolean（可选）

omni_reference_task_typestring（可选）

output_formatstring（可选）

toolsobject[]（可选）

属性

statusstring

errorobject / null

属性

contentobject

属性

generate_audioboolean

output_formatstring

usageobject

属性

目录