Seedance 2.0 是字节跳动豆包（Doubao）系列的旗舰视频生成模型，支持文生视频、首尾帧图生视频与多模态参考生成，并可同步生成与画面匹配的音频。LoopRouter 以与火山引擎方舟完全一致的接口对外提供该能力。

​
快速入口

视频生成 API

完整参数、三种生成模式、响应结构与错误码

在线调试（试一试）

在文档内直接发起真实请求

素材库

上传素材、管理素材组，获取 asset ID

真人认证接口

真实人像素材的活体认证全流程 API

​
核心特性

多模态参考生成

单次请求最多组合 9 张参考图、3 段参考视频、3 段参考音频，保持角色与风格一致

音画同步

generate_audio 默认开启，人声、音效与配乐与画面同步生成

高分辨率

支持 480p / 720p / 1080p / 4k 多档输出，固定 24fps（可用档位依分组）

片段续接

return_last_frame 返回末帧图，用作下一段视频的首帧，串联多个片段

​
模型清单

模型名与火山官方快照版本号保持一致（doubao-seedance-2-0-260128），不需要 ep- 开头的接入点 ID。实际可用模型以控制台「模型广场」为准。

​
技术规格

​
端点一览

Base URL：https://api.looprouter.com
所有接口统一使用 Authorization: Bearer sk-... 请求头，API Key 在 控制台 → 令牌 创建。路径中的 /api 前缀不能省略。

​
模型定价

计费采用提交预扣、完成结算的两段式流程：
1

提交预扣

任务创建成功后，按请求参数（分辨率、时长）预估并预扣一笔额度，日志中心会产生一条预扣记录。
2

完成结算

任务成功后按上游返回的实际用量（usage.total_tokens，约等于 时长 × 输出宽 × 输出高 × 24 ÷ 1024）重新计算，多退少补；任务失败则全额退回预扣。
视频输入折扣：当请求 content 中包含参考视频（video_url）时，系统自动应用带视频输入的优惠倍率，无需额外传参。不扣费场景：参数校验失败（400）、内容审核拒绝（403）均不产生费用。
使用 duration: -1（模型自选时长）或 ratio: adaptive 时，实际费用以任务成功后响应中回填的真实时长/分辨率为准，与预扣金额可能存在差额，结算时自动多退少补。
各分辨率档位的具体单价请以控制台「模型广场」与「日志中心」展示为准。实际扣费还会应用 API Key 所在分组的计费倍率（具体折扣以商务对接约定为准），分组同时决定可用的分辨率档位。

​
限流与重试

  • 平台按渠道维度做 RPM 智能调度：并发高峰时任务会短暂排队而不是直接失败。
  • 收到 429（当前分组上游负载已饱和，请稍后再试）或 5xx 时，建议指数退避重试（2s → 4s → 8s）。
  • 轮询查询接口建议间隔 15–30 秒；720p / 5 秒视频的典型生成耗时约 2–5 分钟。

​
常见问题

这是异步任务接口：创建仅入队并返回任务 ID，需轮询 GET /api/v3/contents/generations/tasks/{id} 直到状态变为 succeeded，再从 content.video_url 下载成片。
是 succeeded。判断终态请匹配 succeeded / failed / cancelled / expired 四个值。
可用档位由 API Key 所在的分组决定：VIP 组支持 480p、720p、1080p、4k 全档位，补贴组支持 720p、1080p。传入分组不支持的档位会返回 400（错误信息会列出当前可用档位），且不扣费。
不支持。callback_url 会被 400 拒绝，请使用轮询获取任务结果。
content.video_url 是约 2 小时有效的临时链接，过期后重新调用查询接口会得到新的下载链接；但任务本身也有保留期限，请在生成后尽快转存到自己的存储。
不能。出于防深度伪造要求，真实人脸图片不能直接放入 image_url（会被内容审核 403 拒绝）。需先完成 真人认证，把照片上传到认证素材组，再以 asset://素材ID 引用。
不能保证完全一致。相同 seed 与参数会得到高度相近的结果，适合微调提示词时保持整体构图稳定。
在请求头加 Accept-Encoding: identity。个别网络环境下网关 gzip 协商会导致 requests 解码异常。

​
相关文档

视频生成 API

参数与响应详解

素材引用实战

端到端角色一致性教程

快速开始

三步跑通第一个视频