Seedance 2.0文生视频API-豆包AI文本生成视频-AutoRouter

通过文本提示词生成有声/无声视频。异步任务接口，提交后返回任务 ID，需轮询任务状态获取结果。

通过文本提示词生成 1 个目标视频，支持有声 / 无声输出。最长 15 秒，最高 4K 分辨率（标准版）。

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

仅支持 Doubao Seedance 2.0 系列模型。

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

Properties:

Name	Type	Required	Description
`model`	string	Yes	模型 ID。可选值见下方说明
`content`	object[]	Yes	输入内容列表。文生视频仅需 1 个 `type=text` 元素
`content[].type`	string	Yes	内容类型，此处固定为 `text`
`content[].text`	string	Yes	文本提示词
`resolution`	string	No	视频分辨率。详见下方说明
`ratio`	string	No	视频宽高比。详见下方说明
`duration`	integer	No	视频时长（秒）。取值 `[4, 15]` 或 `-1`，默认 `5`
`generate_audio`	boolean	No	是否生成有声视频。`true`（默认）有声，`false` 无声
`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 强校验方式。

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。

textstring（必选）

文本提示词，描述期望生成的视频。

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

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

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

说明：标准版输出的 4K 视频采用 10bit 位深、H.265 编码，少数播放环境可能不兼容。

ratiostring（可选）

生成视频的宽高比例。默认 adaptive（根据 prompt 自动选择最合适的宽高比）。

可选值：16:9、4:3、1:1、3:4、9:16、21:9、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 时，模型在有效取值范围内自主选择合适的整数秒时长。

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

generate_audioboolean（可选）

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

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

注意：生成的有声视频均为单声道。

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-0-260128",
  "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 小时，请及时下载或转存

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 参数错误

场景	处理建议
未传 `content` / `model`	补全必填字段
未知模型名	使用文档列出的三个 Seedance 2.0 模型 ID
分辨率不在模型支持范围	Fast / Mini 不支持 `1080p`、`4k`

HTTP 401 / 403 鉴权错误

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

HTTP 402 余额不足

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

任务 `failed` / `expired` 状态

原因	处理建议
内容审核失败	调整提示词，避免敏感内容
参数组合非法	按 Request Body 规范传参
任务超时	通过 `execution_expires_after` 调整超时阈值后重试

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

文生视频

modelstring（必选）

contentobject[]（必选）

属性

resolutionstring（可选）

ratiostring（可选）

durationinteger（可选）

generate_audioboolean（可选）

toolsobject[]（可选）

属性

statusstring

errorobject / null

属性

contentobject

属性

generate_audioboolean

usageobject

属性

目录