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/cat.jpg"
      },
      "role": "first_frame"
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

Example（首尾帧）：

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "镜头从近景缓慢拉远"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first.jpg"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last.jpg"
      },
      "role": "last_frame"
    }
  ],
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}

Properties:

Name	Type	Required	Description
`model`	string	Yes	模型 ID。可选值见下方说明
`content`	object[]	Yes	输入内容列表，含文本（可选）与图片
`content[].type`	string	Yes	内容类型：`text` 或 `image_url`
`content[].text`	string	No	文本提示词（`type=text` 时）
`content[].image_url`	object	Yes*	图片对象（`type=image_url` 时必填）
`content[].image_url.url`	string	Yes*	图片 URL、Base64 或素材 ID
`content[].role`	string	视场景	图片用途：`first_frame` / `last_frame`
`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 字符）

说明：resolution、ratio、duration、watermark 也支持在提示词后追加 --[parameters] 弱校验传参。推荐使用 request body 强校验方式。

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：图片

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 张

rolestring（视场景）

图片的位置或用途。

图生视频-首帧

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

图生视频-首尾帧

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

首帧：first_frame
尾帧：last_frame

说明：首尾帧图片可相同。宽高比不一致时以首帧为主，尾帧会自动裁剪适配。选择的宽高比与上传图片不一致时，平台会居中裁剪。

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：输出无声视频

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

return_last_frameboolean（可选）

是否返回生成视频的尾帧图像。默认 false。

设为 true 后，可通过查询任务接口获取尾帧 PNG（无水印，宽高与视频一致）。可用于将上一段视频的尾帧作为下一段的首帧，生成连续视频。

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": "image_url",
      "image_url": {
        "url": "https://example.com/cat.jpg"
      },
      "role": "first_frame"
    }
  ],
  "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 张；首尾帧场景须 2 张且 `role` 必填
首帧 / 首尾帧 / 参考生视频混用	三种场景互斥，不可混用
图片格式 / 尺寸不合规	参考 `image_url.url` 限制
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（可选）

return_last_frameboolean（可选）

statusstring

errorobject / null

属性

contentobject

属性

generate_audioboolean

usageobject

属性

目录