Seedance 视频概览
这一页帮你选线路和模型，并先把「能做什么、不能做什么」看清楚，再决定怎么接入。
模型能力矩阵
Section titled “模型能力矩阵”目前收录 Seedance 2.0 与 2.5 两个模型。模型 ID 请使用带日期的完整名称，各项规格的含义见模型与规格。
| 模型 | 模型 ID | 分辨率 | 时长 | 参考视频 |
|---|---|---|---|---|
| Seedance 2.0 | doubao-seedance-2-0-260128 | 480p720p1080p4k | 4–15 秒 | 支持 |
| Seedance 2.5 | doubao-seedance-2-5-260628 | 480p720p1080p | 4–30 秒 | 支持 |
| 能力 | 状态 | 怎么用 |
|---|---|---|
| 创建视频任务 | 支持 | 方舟原生 POST /api/v3/contents/generations/tasks（推荐）；也兼容 /v1/videos 与 /v1/video/generations |
| 查询任务、获取视频 | 支持 | 按任务号查询；成片直链 24 小时有效，也可经 /v1/videos/{id}/content 下载 |
| 任务记录 | 支持 | 控制台「常规 → 任务日志」查看全部任务的状态、耗时与视频，每单费用见「使用日志」；程序里保存创建时返回的任务号即可随时查询 |
| 参考素材（图片、视频、音频） | 支持 | 把公网可访问的 HTTPS 链接直接写进 content，无需预先上传或入库 |
| 获取结果 | 支持 | 查询接口轮询，建议每 10–15 秒一次；任务在后台自动完成，客户端断开连接不影响 |
| 费用保障 | 支持 | 预扣多退少补；失败、超时自动全额退款；被拒绝的请求不扣费 |
| 方舟视频参数 | 支持 | duration、resolution、ratio、generate_audio、watermark、return_last_frame 等已实测生效 |
个别参数与 SDK 方法的使用提示见错误与排错里的「使用提示」。
接口路径一览
Section titled “接口路径一览”基础地址 https://api.boyueasi.com。推荐使用方舟原生格式；如果你的程序已经按 OpenAI 视频格式写好，也可以用兼容接口，但要注意它会丢弃部分顶层参数。
| 用途 | 路径 | 说明 |
|---|---|---|
| 创建任务 | POST /api/v3/contents/generations/tasks |
方舟原生格式，推荐 |
| 查询任务 | GET /api/v3/contents/generations/tasks/{task_id} |
方舟原生格式，推荐 |
| 创建任务 | POST /v1/videos |
OpenAI 视频格式，见兼容接口 |
| 创建任务 | POST /v1/video/generations |
旧统一格式，见兼容接口 |
带前缀的 /doubao/api/v3/... 与上面的原生路径等价，行为和返回完全一致，已经在使用的接入方可以继续用。
下一步：去快速开始，五分钟跑通第一次调用。