Seedance 视频生成

提交豆包 Seedance 视频生成任务（文生、首帧 / 首尾帧、全模态参考）。

请求地址仍为 POST /v1/video/generations，完成后用 GET /v1/video/generations/{task_id} 查询。

prompt 必填，推荐只用 prompt 传提示词。

素材只通过 metadata.content 传入。首帧必须写 role=first_frame；不写 role 时按参考素材提交。

人像库（自 Seedance 2.0 起）： 参考图、参考视频、首帧等素材中包含人脸时，须先完成人像库审核，待 status 为 Active 后，在 metadata.content 中传入 asset://{asset_id}（不要用原始 HTTPS，也不要用 resolved_url）；否则人脸无法用于视频生成。不含人脸的场景图可继续直接传公网 URL。适用于 2.0 及后续所有版本。

提示词里用「图片 1」「图片 2」指代 content 中的素材，不要把 asset://... 写进 prompt。

各版本能力与字段说明见下方接口文档。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型 ID。

模型	主要能力
Seedance 2.5	文生 / 首帧 / 首尾帧 / 全模态参考；最长 30s；样片模式；可单独传音频
Seedance 2.0	文生 / 首帧 / 首尾帧 / 全模态参考；最长 15s；支持 4k
Seedance 2.0 Fast	同 2.0 能力面；仅 `480p`/`720p`
Seedance 2.0 Mini	同 2.0 能力面；仅 `480p`/`720p`
Seedance 2.0（国际线路同款）	参数同 2.0
Seedance 2.0 Fast（国际线路同款）	参数同 2.0 Fast
Seedance 1.5 Pro	文生 / 首帧 / 首尾帧；有声/无声
Seedance 1.0 Pro	文生 / 首帧 / 首尾帧
Seedance 1.0 Lite 文生	仅文生视频
Seedance 1.0 Lite 图生	仅首帧图生视频

prompt*string

文本提示词，必填。

推荐只用本字段传提示词，保持一条文案。
提交时写入 content 的 type=text；若 metadata.content 中已有相同 text，则不再重复追加。
中文建议不超过 500 字，英文建议不超过 1000 词。

duration?integer

生成视频时长（秒）。超出模型合法范围会报错。

模型	合法范围	说明
Seedance 2.5	`[4, 30]` 或 `-1`	`-1` 为智能选时长；视频编辑任务必须为 `-1`
Seedance 2.0 / Fast / Mini	`[4, 15]` 或 `-1`	`-1` 为智能选时长
Seedance 1.5 Pro	`[4, 12]`	—
Seedance 1.0 系列	`[2, 12]`	—

也可传 seconds（字符串），优先级高于本字段。

resolution?string

分辨率。

模型	合法分辨率	默认
Seedance 2.5	`480p` / `720p` / `1080p`	`720p`
Seedance 2.0	`480p` / `720p` / `1080p` / `4k`	`720p`
Seedance 2.0 Fast / Mini	`480p` / `720p`	`720p`
Seedance 1.5 Pro	`480p` / `720p` / `1080p`	`720p`
Seedance 1.0 系列	`480p` / `720p` / `1080p`	`1080p`

ratio?string

宽高比。可选：16:9、4:3、1:1、3:4、9:16、21:9、adaptive（自适应，由模型根据输入内容或提示词自动选择宽高比）。

2.0 / 2.5 / 1.5 默认常为 adaptive；1.0 文生默认 16:9。
Seedance 2.5：首帧 / 首尾帧、视频编辑、视频延长任务仅允许 adaptive（可不传，由模型自适应）。

seed?integer

随机种子，用于控制生成结果的可复现性。取值范围 [-1, 2147483647]，-1 表示随机。

优先使用本字段；也可写在 metadata.seed，外层本字段覆盖 metadata。主要适用于 Seedance 1.0 系列，其他型号透传效果因模型而异。

metadata?

豆包 Seedance 扩展参数。未支持或非法的字段可能被忽略或导致请求失败。

字段

字段	类型	支持模型	说明
`generate_audio`	boolean	2.5、2.0 系列、1.5 Pro	是否生成有声视频，默认 `true`
`return_last_frame`	boolean	全部	是否返回尾帧图，默认 `false`
`watermark`	boolean	全部	是否添加「AI 生成」水印，默认 `false`
`camera_fixed`	boolean	仅 1.5 Pro / 1.0 系列	固定摄像头；2.0/2.5 不支持
`draft`	boolean	仅 2.5	样片模式；开启时只能 `480p`
`service_tier`	string	主要 1.0 / 1.5	`default` / `flex`。2.0 / 2.5 不支持 flex
`frames`	integer	仅 1.0 系列	按帧数控制时长；与 `duration` 二选一，`frames` 优先
`content`	array	全部（能力因模型而异）	多模态素材，见下方
`tools`	array	2.5、2.0 系列	如 `[{"type":"web_search"}]` 开启联网搜索
`omni_reference_task_type`	string	仅 2.5	全模态子任务引导：`auto`（默认）/ `reference` / `edit` / `extend`。用于提前提交校验，减少异步报错
`output_format`	string	仅 2.5	`mp4`（默认，通用兼容）/ `mov`（专业后期，编辑 / 延长更推荐）

omni_reference_task_type 约束摘要：

edit：content 须含 reference_video（单段 4–30s）；ratio 须 adaptive（自适应）；duration 须 -1
extend：须含 reference_video；ratio 须 adaptive（自适应）
reference：ratio / duration 无上述特殊限制

`content` 元素结构

字段	类型	说明
`type`	string	`image_url` / `video_url` / `audio_url` / `draft_task`（2.5）
`role`	string	见下表
`image_url.url`	string	图片地址；含人脸须 `asset://{asset_id}`，否则可用公网 URL / Base64
`video_url.url`	string	视频地址；含真人须 `asset://{asset_id}`，否则可用公网 URL
`audio_url.url`	string	音频地址；需审核时用 `asset://{asset_id}`，否则可用公网 URL / Base64
`draft_task.id`	string	仅 2.5：样片任务 ID，用于生成正式视频

role 取值：

role	适用 type	说明
`first_frame`	image_url	首帧。必须显式填写，省略时按参考图提交
`last_frame`	image_url	尾帧；须同时有首帧
`reference_image`	image_url	参考图（全模态）
`reference_video`	video_url	参考视频（全模态）
`reference_audio`	audio_url	参考音频（全模态）

互斥规则：「首帧/首尾帧」与「全模态参考（图/视频/音频）」不可混用。

人脸素材（自 Seedance 2.0 起）： 图 / 视频中含人脸时，须先完成人像库审核并通过，再在对应 *.url 中传 asset://{asset_id}；不要传原始 HTTPS 或 resolved_url。不含人脸的场景图可直接传公网 URL。提示词用「图片 1」等指代，不要写 asset ID 原文。

素材数量与时长上限：

项目	Seedance 2.5	Seedance 2.0 系列
参考图	1–30 张	1–9 张
参考视频	≤10 个；单段非编辑 `[2,30]`s，编辑 `[4,30]`s；合计 ≤30s	≤3 个；单段/合计 ≤15s
参考音频	≤10 段；单段/合计 ≤30s；可单独传音频	≤3 段；单段/合计 ≤15s；不可单独传音频

1.5 / 1.0 主要使用首帧 / 首尾帧图片，不支持参考视频与参考音频。

Response Body

application/json

curl -X POST "https://loading/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "清晨海岸公路，镜头缓慢推进，海风吹过路旁草木",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 8,
    "metadata": {
      "generate_audio": true,
      "watermark": false
    }
  }'

curl -X POST "https://loading/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "doubao-seedance-2-5-260628",    "prompt": "清晨海岸公路，镜头缓慢推进，海风吹过路旁草木",    "resolution": "720p",    "ratio": "16:9",    "duration": 8,    "metadata": {      "generate_audio": true,      "watermark": false    }  }'

{
  "task_id": "cgt-20260323xxxxxx",
  "status": "queued"
}

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Seedance 视频生成

Authorization

Request Body

字段

content 元素结构

Response Body

200application/json

400application/json

`content` 元素结构

application/json

application/json