Seedance 2.0 视频生成接口文档

提交异步视频生成任务。服务端按传入素材字段自动判定生成模式：

只传 prompt → 文生视频

prompt + reference_image_urls（1~9 张）→ 图生视频

再叠加 reference_videos / reference_audios（须 ≥1 图）→ 全能参考

prompt + first_image_url + last_image_url → 首尾帧过渡（该模式不接受额外参考图）

同时支持 application/json 与 multipart/form-data（multipart 仅支持单图，多图请用 JSON）。

模型（按秒计费，失败不计费）

模型	清晰度	定位	duration
`Seedance-2.0-mini-720p`	720p	mini 档，高清最低价，走量首选	4-15 任意整数（缺省默认 4）
`Seedance-2.0-fast-480p`	480p	经济档，快速出片	4-15 任意整数（缺省默认 4）
`Seedance-2.0-fast-720p`	720p	高清快速出片，性价比高	4-15 任意整数（缺省默认 4）
`Seedance-2.0-720p`	720p	高清标准，质量更佳	4-15 任意整数（缺省默认 4）
`Seedance-2.0-1080p`	1080p	超清标准，最高画质	4-15 任意整数（缺省默认 4）
`Seedance-2.0-4k`	4K	4K 超高清，顶级画质	4-15 任意整数（缺省默认 4）

duration 越界不报错而是自动限幅：传 20 → 按 15 生成；传 3 → 按 4 生成（计费按实际生成秒数，创建响应 seconds 字段反映限幅结果）。duration 传整数型字符串（如 "4"）也会被正常解析接受，仅非数字字符串才会报错。

输出规格

H.264 / 24fps MP4，含 AAC 立体声（2ch, 44.1kHz）同步音轨，无水印

画幅支持 16:9 / 9:16 / 1:1 / 21:9 / 3:4 / 4:3

成片从查询接口响应的 video_url 直链下载。链接可能为长期直链，也可能是带 24 小时时效的临时签名链接，建议拿到链接后尽快转存

实际生成时长会比请求的 duration 略多（约 +0.1s），属正常现象

480p 档在 16:9 / 9:16 画幅下，因编码对齐，实际输出为 864×496 / 496×864（与精确比例略有偏差）；其余画幅与清晰度档位均为精确比例

素材要求

素材	数量	格式	大小/尺寸限制	传参字段	prompt 引用
参考图	≤9 张	JPEG / PNG / WEBP	≤30MB；长边 ≤4000px，每边 ≥300px；宽高比 0.4–2.5	`reference_image_urls`	`@image1`~`@image9`
参考视频	≤3 个	mp4 / mov	单条 ≤50MB、2–15 秒、24–60fps；多条总时长 ≤15 秒	`reference_videos`	`@video1`~`@video3`
参考音频	≤3 个	mp3（支持 wav/m4a）	—	`reference_audios`	`@audio1`~`@audio3`
首尾帧	固定 2 张	同参考图	同参考图	`first_image_url` + `last_image_url`	—

三种传入方式（素材字段通用，任选其一）

方式	写法示例	说明
公网 URL	`"reference_image_urls": ["https://cdn.example.com/dog.jpg"]`	最常用，链接需可公开访问
base64 直传	`"image_url": "data:image/jpeg;base64,/9j/4AAQ..."`	免图床，适合本地素材
multipart 上传	`-F "image=@photo.jpg"`	免图床，仅支持单图，多图请用 JSON

注意事项

@image1 对应数组第 1 个素材，依次类推（如 prompt 写「@image1 的人物走进 @image2 的场景」）

参考视频 / 参考音频必须搭配 ≥1 张参考图（放 reference_image_urls），否则提交会被直接拒绝（invalid_reference，不产生任务不扣费）；锚定图请放 reference_image_urls（只传 image_url 会被拒）

prompt ≤5000 字符（含 @ 引用文字）

参考图 / 首尾帧画面会经过内容审核，涉及真人敏感着装、名人肖像、疑似未成年、血腥暴力等内容容易被拦截（POLICY_VIOLATION），同一张图重试无效，建议更换素材或改用插画风格；首尾帧 / 全能参考模式的审核尺度会更严格一些

注

duration 越界自动限幅（20→15、3→4），计费按实际生成秒数

省略 duration 时默认生成 4 秒

参考视频/音频不配图会被同步拒绝（invalid_reference），不产生任务不扣费

只传 first_image_url 不传 last_image_url 不报错，会按普通图生视频处理

失败任务不计费；GENERATION_FAILED 多为高峰期波动，重试即可；排队较久未进入生成节点也可能超时失败，建议错峰提交或加自动重试

轮询任务状态请使用创建时返回的 id；查询响应中的 task_id 是上游侧的 id，与 id 不同，不能拿来查询

✅ 可直接复制的 curl 示例

1. 文生视频（最简）

2. 图生视频（单图，reference_image_urls 传 1 个元素）

3. 多参考图（≤9 张，prompt 用 @image1/@image2 引用）

4. 多角色命名绑定（推荐对象数组，name 跟图走不错位）

5. 人物图 / 背景图角色标注（治多图融合"背景长出人脸"）

6. 全能参考 · 参考视频（须至少配 1 张图锚定画面）

7. 全能参考 · 参考音频（音频驱动节奏，须配 ≥1 图）

8. 首尾帧过渡（first + last 成对必传）

9. base64 直传（免图床，data URI 填进 image_url / reference_image_urls）

10. multipart 本地文件上传（免图床，仅支持单图）

application/json

任务创建成功（异步，需轮询查询接口取结果）

Bodyapplication/json

示例

{
    "id": "task_itYSMfIcOsL9Mevjzo36iqGA2qE3zqlY",
    "task_id": "task_itYSMfIcOsL9Mevjzo36iqGA2qE3zqlY",
    "object": "",
    "model": "Seedance-2.0-fast-480p",
    "status": "queued",
    "progress": 0,
    "created_at": 1784128043,
    "seconds": "4"
}

创建 Seedance 视频任务（文生 / 图生 / 全能参考 / 首尾帧）

Seedance 2.0 视频生成接口文档

模型（按秒计费，失败不计费）

输出规格

素材要求

注

✅ 可直接复制的 curl 示例

请求参数

请求示例代码

返回响应

创建 Seedance 视频任务（文生 / 图生 / 全能参考 / 首尾帧）

Seedance 2.0 视频生成接口文档#

模型（按秒计费，失败不计费）#

输出规格#

素材要求#

注#

✅ 可直接复制的 curl 示例#

请求参数

请求示例代码

返回响应

Seedance 2.0 视频生成接口文档

模型（按秒计费，失败不计费）

输出规格

素材要求

注

✅ 可直接复制的 curl 示例