Seedance 按次版接入

先选型号

本页介绍已开通的 Seedance 按次视频型号。调用前用你的 Key 请求 GET /v1/models，确认对应 ID 在可用列表中；公开目录不代表每个 Key 都有权限。 使用视频站“混合”组 Key，服务根地址为 https://video.1route.dev。

展示名称	API 模型 ID	时长	标准售价
Seedance 2.0 Mini · 12秒	`seedance-2.0-mini-12s`	固定 12 秒	¥1.02/次
Seedance 2.5 · 多图版	`seedance-2.5-30img`	4–30 整数秒	¥2.16/次

金额为人民币余额单位，不按美元汇率换算。上述价格为“混合”组公开价格快照，当前账户适用价格以本站价格页为准。每个任务只计 1 次，不再乘秒数、图片张数或 Token 数。 排队与查询不新建生成任务。

这两款不是按 Token 计费的其他 Seedance 型号，不能混用名称、参数或公式。给 AI 同时提供模型规范与价格和 OpenAPI。

2.5 多图版：4–30 整数秒，固定 720P；最多 30 张参考图、10 段 MP3 音频；支持 6 种画幅和人脸参考；可用 face=true 开启参考图彩铅化，默认关闭；不支持参考视频。

可以直接交给 AI 的要求

请按这份页面和对应 OpenAPI 接入 1Route Seedance 按次视频模型。
从私密配置读取 VIDEO_API_KEY，不打印 Key，不放到公开网页代码中。
先 GET /v1/models 确认权限，再核对本站账户价格及人民币预算。
只用页面中的公开 model ID。Mini 版固定 12 秒、纯文字；多图版为 4–30 整数秒。
多图版固定720P，最多30图、10段MP3；ratio只能选文档列出的6种值，face用JSON布尔值，默认false。
不要套用 WAN3 字段，不要按时长或 Token 计算这两款费用。
没有预算确认不生成；创建只发一次，立即保存 id 和 X-Oneapi-Request-Id。
每 15 秒查询同一个任务；completed 且拿到本站链接后立即下载。
超时或 5xx 不自动重发 POST；GET 可退避重查。文件未交付时联系支持，不重新生成。

请求字段

POST /v1/videos，JSON 请求，使用 Authorization: Bearer YOUR_API_KEY。

字段	Mini 12秒版	2.5 多图版
`model`	`seedance-2.0-mini-12s`	`seedance-2.5-30img`
`prompt`	必填，1–2000 字符	必填，1–2000 字符；多图按 Image 1、Image 2 说明用途
`seconds`	必填，整数 `12`	必填，整数 `4` 到 `30`
`resolution`	可省略，或 `720p`；使用默认输出	固定 `720p`；可省略，其他非空清晰度字符串会统一改为 `720p`
`images`	不支持，省略	可省略，最多 30 个公网图片 URL 字符串
`audios`	不支持，省略	可省略，最多 10 个 MP3 音频 URL 字符串
`ratio`	不支持，省略	可选：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`21:9`；不传则使用模型默认画幅
`face`	不支持，省略	可选，JSON 布尔值；`true` 开启参考图彩铅化，默认 `false`

不接受 aspect_ratio、duration、size、videos、reference_images 或额外计费字段。不支持 multipart 文件上传、base64、网盘预览页或需要登录的素材链接。上表新增的音频、画幅和 face 字段只适用于 2.5 多图版，不能发送给 Mini 版。

Mini 样片为 720×1280 竖屏，当前不提供画幅选择。2.5 多图版固定使用 720P 档位，所以发送 480p 不会得到 480P 成片；宽高随画幅变化，不要把所有画幅都写死为 1280×720。

音频必须是真正的 MP3 文件，不能只把 WAV 等文件改后缀。本站要求音频 URL 的路径以 .mp3 结尾，可以带签名查询参数；不符合后缀规则会在入口被拒绝，文件实际能否解码还取决于内容。

face 是参考图的彩铅化预处理开关，不是“保证所有人脸素材都通过”的开关。true、false 不加引号。最多 30 图、10 音频是输入上限，不保证每份素材都完整体现在成片中；使用素材前应取得合法授权。音频、六种画幅及 face 能力按接口说明提供，本轮未新增付费生成验证。

最小请求

确认预算后，从两段示例中选一段提交，不要同时运行两段。

{
  "model": "seedance-2.0-mini-12s",
  "prompt": "一只彩色风筝在蓝天与草地之间轻轻摇曳，镜头缓慢推进，自然光，无文字。",
  "seconds": 12
}

{
  "model": "seedance-2.5-30img",
  "prompt": "一只彩色风筝在草地上空轻轻摇曳，镜头缓慢推进，自然光，无文字。",
  "seconds": 4,
  "resolution": "720p"
}

多图版需要图片时增加 "images": ["https://YOUR_MEDIA_HOST/reference.jpg"]，先替换为已获授权的真实图片直链。不要提交占位符，不要未经同意上传私人素材。

2.5 图片与音频参考示例

先替换两个素材占位符。该示例同样只计一次费用，不因时长、素材数量或 face 开关增加单价。

{
  "model": "seedance-2.5-30img",
  "prompt": "Image 1 为场景参考，参考 Audio 1 的节奏生成连贯镜头。",
  "seconds": 12,
  "resolution": "720p",
  "ratio": "16:9",
  "images": ["https://YOUR_MEDIA_HOST/reference.jpg"],
  "audios": ["https://YOUR_MEDIA_HOST/reference.mp3"],
  "face": false
}

等待和下载

保存创建响应的完整 id。模型名称不是任务 ID。
每 15 秒 GET /v1/videos/{id}，使用同一 Key；queued、in_progress 继续等待。
completed 后读取 metadata.url，也可使用响应提供的 url。没有链接则继续查询同一任务或联系支持，99% 不等于可以下载。
原样使用返回的本站签名链接下载 MP4，不附加 API Key、不替换主机或签名参数。链接最长约 5 分钟，准备好的缓存文件约保留 10 分钟，请及时保存。

创建超时或连接中断不能证明任务没生成，不能自动重发。终态失败请核对任务与用量记录；生成成功但交付失败时保留费用，联系支持补交视频或处理退款。程序重启后从已保存的 ID 恢复查询；不假设支持取消或幂等创建。