Seedance 2.5 是字节跳动豆包（Doubao）系列的视频生成模型，支持文生视频、首帧 / 首尾帧图生视频、多模态参考、视频编辑与视频延长，单次生成最长 30 秒，并可同步生成音频。LoopRouter 使用火山引擎方舟兼容接口；从 2.0 迁移时，还需检查素材数量、任务类型、宽高比和输出格式，不能只替换 model。
平台支持 output_format（mp4 / mov）和 omni_reference_task_type（auto / reference / edit / extend），查询结果会在上游返回时提供 output_format。这两个参数仅适用于 Seedance 2.5；不传时使用官方默认值。详见 输出格式与任务类型参数。

​
快速入口

视频生成 API

请求参数、素材与编码规格、任务类型约束、响应与错误码

在线调试（试一试）

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

素材库

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

真人认证接口

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

​
核心特性

更长单段时长

时长范围扩展到 4–30 秒，一次生成即可覆盖更完整的镜头叙事

多模态参考生成

最多 30 张参考图、10 个参考视频、10 段参考音频，也支持仅输入音频

音画同步

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

高清分辨率

支持 480p / 720p / 1080p 三档输出，固定 24fps

​
模型清单

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

​
技术规格

从 2.0 迁移：2.5 的时长上限为 30 秒，参考素材上限提升至 30 图 / 10 视频 / 10 音频，支持仅输入音频；输出最高 1080p，不支持 4k。首帧 / 首尾帧、编辑、延长任务必须使用 ratio: adaptive，编辑任务还必须使用 duration: -1。output_format 和 omni_reference_task_type 是 2.5 专属参数，切回 2.0 时应移除。

​
端点一览

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 时，实际费用以任务成功后响应中回填的真实时长/分辨率为准，与预扣金额可能存在差额，结算时自动多退少补。长时长任务（如 30 秒）请预留充足余额。
各分辨率档位的具体单价请以控制台「模型广场」与「日志中心」展示为准。实际扣费还会应用 API Key 所在分组的计费倍率（具体折扣以商务对接约定为准），分组同时决定可用的分辨率档位。

​
限流与重试

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

​
常见问题

两者使用相同端点，但 2.5 的时长、素材数量、仅音频输入、输出格式与任务类型约束都有变化。尤其是首帧 / 首尾帧、编辑、延长任务仅支持 ratio: adaptive，编辑任务仅支持 duration: -1。请按 视频生成 API 检查参数，不能只替换模型名。
这是异步任务接口：创建仅入队并返回任务 ID，需轮询 GET /api/v3/contents/generations/tasks/{id} 直到状态变为 succeeded，再从 content.video_url 下载成片。
是 succeeded。判断终态请匹配 succeeded / failed / cancelled / expired 四个值。
Seedance 2.5 支持 480p、720p、1080p 三档，默认 720p；暂不支持 4k（传入 4k 会返回 400 且不扣费）。
不支持。callback_url 会被 400 拒绝，请使用轮询获取任务结果。
官方默认输出 MP4，1080p 规格采用 10bit 与 H.265/HEVC，播放器需支持相应解码。设置 output_format: mov 可选择面向专业后期的 MOV，官方格式说明为 H.264 + yuv444p + PCM，部分播放器不兼容。MOV 请求保留上游原生规格产物。输入视频的容器与编码要求见 素材要求。
官方原始视频 URL 有效期为 24 小时，Seedance 2.5 视频 URL 最多下载 100 次；平台转存链接的有效期以实际存储策略为准。请在任务成功后尽快下载并转存，不要依赖重新查询来刷新过期链接。任务记录仍可查询不代表视频文件永久可下载。
不能。出于防深度伪造要求，真实人脸图片不能直接放入 image_url（会被内容审核 403 拒绝）。需先完成 真人认证，把照片上传到认证素材组，再以 asset://素材ID 引用。
在请求头加 Accept-Encoding: identity。个别网络环境下网关 gzip 协商会导致 requests 解码异常。

​
相关文档

视频生成 API

参数与响应详解

素材引用实战

端到端角色一致性教程

快速开始

三步跑通第一个视频