# Seedance 按次版接入

https://video-doc.1route.dev/zh/docs/seedance-flat



## 先选型号 [#先选型号]

本页介绍已开通的 Seedance 按次视频型号。**调用前用你的 Key 请求 `GET /v1/models`，确认对应 ID 在可用列表中；公开目录不代表每个 Key 都有权限。** 使用视频站“低价混合”组 Key，服务根地址为 `https://video.1route.dev`。如果旧 Key 仍选着“混合”，请在控制台改选当前的“低价混合”组，并保留所需的模型权限。

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

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

这三款不是按 Token 计费的其他 Seedance 型号，不能混用名称、参数或公式。给 AI 同时提供 [模型规范与价格](/seedance-flat-models.json) 和 [OpenAPI](/seedance-flat-openapi.json)。

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

## 可以直接交给 AI 的要求 [#可以直接交给-ai-的要求]

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

## Mini 与 2.5 版请求字段 [#mini-与-25-版请求字段]

`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` 能力按接口说明提供，本轮未新增付费生成验证。

## 15秒 480P 版参数与示例 [#15秒-480p-版参数与示例]

`seedance-2.0-15s-480p` 固定 15 秒，售价 **¥1.20/次**。首版开放参考图生成：必须提供 1–9 张图片，可选最多 3 段 MP3 音频；不开放纯文生、参考视频、画幅选择或 `face` 开关。

必填字段为 `model`、`prompt`（1–2000 字符）、整数 `seconds: 15` 和 `images`；`resolution` 可省略或写 `480p`。音频通过 `audios` URL 字符串数组提供，首版采用前述 MP3 入口规则。不要把 2.5 版的 30 图/10 音频上限或额外字段套过来。

已有一张参考图的样片成功交付：约 15 秒、864×496、24fps、含音轨。480P 是档位，不保证短边精确为 480 像素。9 图、3 音频和人脸素材能力尚未逐项实测，不承诺任意人脸都能通过。

先把图片占位符换成已获授权的公网直链，再确认预算；不要提交占位符：

```json
{
  "model": "seedance-2.0-15s-480p",
  "prompt": "Image 1 为场景参考，镜头缓慢推进，保持主体与光线连贯，无文字。",
  "seconds": 15,
  "resolution": "480p",
  "images": ["https://YOUR_MEDIA_HOST/reference.jpg"]
}
```

## 最小请求 [#最小请求]

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

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

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

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

## 2.5 图片与音频参考示例 [#25-图片与音频参考示例]

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

```json
{
  "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
}
```

## 等待和下载 [#等待和下载]

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

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