LoopRouter 的 Seedance 2.0 接口与火山引擎方舟(Ark)同路径、同参数、同响应结构。如果你已经在用方舟的官方 SDK 或自写代码,迁移基本上只有两处改动:Base URL 和 API Key。

只改两处

Base URL

把方舟域名换成 https://api.looprouter.com,路径 /api/v3/contents/generations/tasks 保持不变(/api 前缀不能省略)

API Key

把方舟的 Key 换成 LoopRouter 的 sk- 令牌,请求头仍是 Authorization: Bearer <key>

迁移前后对照

模型名直接用 doubao-seedance-2-0-260128(与方舟快照版本号一致),不需要方舟那种 ep- 开头的接入点 ID。

需要留意的差异点

接入前对照以下几点,可避开绝大多数排障时间:
  1. 分辨率白名单:可用档位由分组决定——VIP 组支持 480p、720p、1080p、4k 全档位,补贴组支持 720p、1080p。传分组外的值会返回 400 且不扣费。
  2. 不支持回调:callback_url 会被 400 拒绝,请用轮询查询任务状态。
  3. 成功终态是 succeeded(不是 completed);终态匹配 succeeded / failed / cancelled / expired。
  4. 真人脸不能直传:真实人脸图片需先走 真人认证,再以 asset:// 引用。
  5. Python requests 建议加请求头 Accept-Encoding: identity,避免个别网络环境 gzip 解码异常。
  6. 成片链接约 2 小时过期,请及时转存;下载时不要带 Authorization 头。

LoopRouter 额外提供的能力

在与方舟兼容的基础上,LoopRouter 还补充了几个原厂之外的便利接口:

迁移自测清单

1

替换 Base URL 与 Key

改完后先跑一条最简单的文生视频(720p / 5 秒)验证连通。
2

核对终态判断

确认代码里判断的是 succeeded,且覆盖了 failed / cancelled / expired。
3

移除回调依赖

如果原来用 callback_url,改为轮询查询接口。
4

校验计费

在 控制台日志中心 核对预扣与结算记录是否符合预期。

相关文档

视频生成 API

参数与响应详解

API Key 与鉴权

令牌与请求头

快速开始

三步跑通第一个视频