Seedance 2.5 视频生成采用异步任务模式:先提交任务拿到任务 ID,再轮询查询接口获取成片。LoopRouter 使用火山引擎方舟兼容端点,支持最长 30 秒、最高 1080p 输出,并支持 output_format 和 omni_reference_task_type。从 Seedance 2.0 迁移时,需重新检查素材数量、任务类型及 ratio / duration 限制。
想先在浏览器里体验?打开 API 参考 → 创建视频生成任务,填入你的 sk- API Key 即可试一试在线发起真实请求。
文生视频、图生视频、多模态参考共用同一个接口,模型根据 content 素材及提示词判断任务类型。模型清单、定价与常见问题见 能力总览。
接入前请注意以下差异点,可以避开绝大多数排障时间:
  1. Base URL 为 https://api.looprouter.com,完整路径是 /api/v3/contents/generations/tasks,/api 前缀不能省略。
  2. resolution 支持 480p / 720p / 1080p(默认 720p;Seedance 2.5 暂不支持 4k)。传入 4k 会直接返回 400,不会扣费。
  3. duration 默认 -1,支持 4–30 秒整数;编辑任务仅支持 -1。首帧 / 首尾帧、编辑、延长任务的 ratio 仅支持 adaptive。
  4. 本接口不支持 callback_url 回调,传入会返回 400;请使用轮询查询任务状态。
  5. 成功状态是 succeeded(不是 completed);成片 content.video_url 为临时链接,请及时转存,详见查询任务。
  6. Python requests 用户建议加请求头 Accept-Encoding: identity,避免个别网络环境下 gzip 解码异常导致响应截断。
  7. output_format / omni_reference_task_type 仅适用于 Seedance 2.5。平台原样透传显式值,不传时使用上游默认的 mp4 / auto;参数合法性与任务类型约束由上游校验。

代码示例

请求参数速查

POST /api/v3/contents/generations/tasks,请求头 Authorization: Bearer sk-...。
callback_url 在本平台不受支持,传入会返回 400。官方未将 Seedance 2.5 列入 seed、frames、camera_fixed 的支持模型,也不支持 service_tier: flex;请勿把这些字段用于 2.5 请求。

输出格式与任务类型参数

这两个参数仅适用于 Seedance 2.5,平台透传至上游;省略时不额外填值,由上游应用默认值。切换为 Seedance 2.0 或其他不支持的模型时应移除。 omni_reference_task_type 只用于全模态参考,文生视频、首帧 / 首尾帧任务不需要设置。auto 由模型按素材和提示词判断任务类型;显式设置 reference / edit / extend 时,上游会在提交阶段提前校验对应参数,但实际意图与指定类型不一致时仍可能异步失败。

content 数组

每个元素为一个内容项,type 决定其结构:

素材要求

  • 图片和视频的宽高比均为 [0.4, 2.5],宽、高均为 [300, 6000] 像素,均包含边界值。
  • 输入视频支持 480p / 720p / 1080p / 4k,总像素数(宽 × 高)须在 [407696, 8295044],帧率为 [24, 60] FPS。支持 4k 输入不代表支持 4k 输出。
  • 请求体不超过 64 MB;图片和音频可使用 Base64 data URI,大文件应使用 URL 或素材 ID;视频不支持 Base64。
输入视频的容器与编码必须同时满足要求: 修改文件扩展名不会改变实际编码。含真人人脸的图片或视频不能直接上传作为参考素材;授权真人素材需先走 素材库 与 真人认证,再以 asset:// 引用。

生成模式

首帧、首尾帧、多模态参考是互斥场景:不能把 first_frame / last_frame 与参考图、参考视频或参考音频混用。多模态参考中可通过提示词描述首尾画面;如需严格约束首尾帧,应使用首尾帧模式。

任务类型与参数约束

平台转发 omni_reference_task_type、ratio 和 duration,不会因为选择了 edit / extend 就自动修正比例或时长。调用方界面选择编辑时,应锁定并提交 ratio: adaptive、duration: -1;选择延长时,只需锁定比例为 adaptive,时长仍可选择 -1 或 4–30 秒整数。不要把原视频的具体宽高比或秒数代替编辑任务要求的特殊值;不符合任务约束的参数由上游拒绝。
编辑任务的实际成片可能为非整数秒,可能比待编辑视频略短(官方说明误差约 0.4 秒)。提示词应明确说明生成新视频、编辑现有视频,或向前 / 向后延长,避免模型判定的任务类型与参数配置冲突。 例如,编辑一段 4–30 秒参考视频并输出 MOV,向创建任务接口提交以下 JSON:
编辑视频并输出 MOV
延长视频时将任务类型改为 extend,在提示词中明确向前或向后延长;仍使用 ratio: adaptive,duration 可为 -1 或 4–30 秒整数。

输出格式与编码

通过 output_format 选择输出容器;这不是直接指定 H.264 / H.265 的编码参数。显式请求 mov 时,平台保留上游原生规格产物,容器、色度采样与音频编码保持不变。默认或显式请求 mp4 的任务按平台默认交付策略处理。 以下为官方原始产物规格;MP4 产物请以下载文件的实际媒体信息为准。
官方分别列出了「1080p:10bit / H.265」和「MOV:H.264 / yuv444p / PCM」的说明,未在该接口文档中明确 1080p + mov 组合的位深与编码优先规则,因此不能把所有 MOV 都写成 H.265,也不能仅凭扩展名推断位深。需要特定规格时,请检查实际文件的媒体信息。
输出帧率固定为 24fps,有声视频为单声道。H.265/HEVC 和 MOV 的 yuv444p / PCM 在部分浏览器或播放器中可能不兼容;官方列出的 MOV 兼容播放器包括 VLC、mpv、ffplay,以及 macOS 上的 IINA。

查询任务

GET /api/v3/contents/generations/tasks/{task_id} 任务状态机:queued → running → succeeded / failed / cancelled / expired。任务记录长期保留,可随时回查。 成功响应示例:
成片地址在 content.video_url 字段,为临时链接。官方原始视频 URL 有效期为 24 小时,Seedance 2.5 视频 URL 下载次数上限为 100 次;平台转存链接的有效期以实际存储策略为准。请及时下载并转存,不要依赖重新查询来刷新过期链接;下载时不要携带 Authorization 头。
output_format 返回上游生成视频的格式(mp4 / mov),单任务查询与任务列表均保留此字段。旧任务或上游未返回时会省略,请勿只凭下载 URL 的后缀判断格式。 查询返回的 duration 为整数秒约数,按「实际总帧数 ÷ 24,向下取整」计算,不保证等于文件的精确时长。例如 133 帧对应约 5.54 秒,接口返回 duration: 5。
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)均不扣费;已预扣的失败任务会自动退款。
部分任务类型错误会在创建成功后异步返回。查询到 status: failed 时检查 error.code:InvalidParameter.TaskTypeConstraint 表示参数与模型判定的任务类型不兼容;官方显式任务类型与实际意图不一致时则为 InvalidParameter.TaskTypeMismatch。

核对依据

本页模型规格依据火山引擎官方 创建视频生成任务(2026-08-21 更新)与 查询视频生成任务(2026-08-19 更新)的文档快照核对;平台差异单独标明。

相关文档

能力总览与定价

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

素材引用实战

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

在线调试

在文档内直接试一试