Seedance 2.0 视频生成采用异步任务模式:先提交任务拿到任务 ID,再轮询查询接口获取成片。接口路径、请求体、响应结构与火山引擎方舟保持一致,已有的官方示例代码只需替换 Base URL 与 API Key 即可运行。
想先在浏览器里体验?打开 API 参考 → 创建视频生成任务,填入你的 sk- API Key 即可试一试在线发起真实请求。
文生视频、图生视频、多模态参考共用同一个接口,仅靠 content 数组的组合区分模式。模型清单、定价与常见问题见 能力总览。
接入前请注意以下差异点,可以避开绝大多数排障时间:
  1. Base URL 为 https://api.looprouter.com,完整路径是 /api/v3/contents/generations/tasks,/api 前缀不能省略。
  2. resolution 可用档位由 API Key 所在分组决定:VIP 组支持 480p、720p、1080p、4k 全档位,补贴组支持 720p、1080p。传入分组外的档位会直接返回 400,不会扣费。
  3. 本接口不支持 callback_url 回调,传入会返回 400;请使用轮询查询任务状态。
  4. 成功状态是 succeeded(不是 completed);成片 content.video_url 为临时链接,请在 2 小时内转存。
  5. Python requests 用户建议加请求头 Accept-Encoding: identity,避免个别网络环境下 gzip 解码异常导致响应截断。

代码示例

请求参数速查

POST /api/v3/contents/generations/tasks,请求头 Authorization: Bearer sk-...。
callback_url 在本平台不受支持,传入会返回 400。Seedance 1.x 的 frames、camera_fixed 等参数对 2.0 模型无效,请勿依赖。

content 数组

每个元素为一个内容项,type 决定其结构: 图片要求:jpeg/png/webp/bmp/tiff/gif/heic/heif,宽高比 (0.4, 2.5),边长 (300, 6000) 像素,小于 30MB。真实人脸图片不能直接作为参考图,需先走 素材库 与 真人认证,再以 asset:// 引用。

生成模式

三种图片用法互斥:同一请求中不能混用首帧/首尾帧与参考图。

查询任务

GET /api/v3/contents/generations/tasks/{task_id} 任务状态机:queued → running → succeeded / failed / cancelled / expired。任务记录长期保留,可随时回查。 成功响应示例:
成片地址在 content.video_url 字段,为临时签名链接(约 2 小时有效),请及时转存;下载时请求中不要携带 Authorization 头。
usage.total_tokens 为上游按「时长 × 分辨率像素 × 帧率」口径折算的视频 token 数,是结算依据。使用 duration: -1 或 ratio: adaptive 时,以响应中回填的实际值为准。

任务列表与取消

本平台在原厂接口之外额外提供两个管理接口: 列出任务 — GET /api/v3/contents/generations/tasks 响应为 {"items": [...], "total": n},元素结构与查询单个任务一致。 取消/删除任务 — DELETE /api/v3/contents/generations/tasks/{task_id} 排队中的任务可以取消;running 状态的任务不可取消(返回 400 invalid_task_status)。成功返回 {}。

错误响应

所有错误采用与火山引擎一致的结构:
429 与 5xx 建议采用指数退避重试(如 2s → 4s → 8s)。参数校验失败(400)与内容审核拒绝(403)均不扣费;已预扣的失败任务会自动退款。

相关文档

能力总览与定价

模型清单、技术规格、计费规则

素材引用实战

从上传素材到角色一致性生成的完整链路

在线调试

在文档内直接试一试