# ToAI

> ToAI 是 Seedance（字节跳动视频生成模型）的 API 服务：一个 API Key 即可调用，按视频 tokens 计费，失败不收费，结果保存在本站。

- 网站: https://toai.trade
- 接口地址: https://api.toai.trade
- 币种: CNY
- 接入方式: 平台接口 https://api.toai.trade/v1/videos/generations; 火山方舟兼容 https://api.toai.trade/api/v3; OpenAI Videos 兼容 https://api.toai.trade/v1

## 模型

- [Seedance 2.0 (seedance-2.0-standard)](https://toai.trade/models/seedance-2.0-standard): Seedance 2.0（seedance-2.0-standard）生成 4–15 秒、480P / 720P / 1080P / 4K 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 2.33 CNY 起（480P）。
- [Seedance 2.0 Fast (seedance-2.0-fast)](https://toai.trade/models/seedance-2.0-fast): Seedance 2.0 Fast（seedance-2.0-fast）生成 4–15 秒、480P / 720P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 1.87 CNY 起（480P）。
- [Seedance 2.0 Mini (seedance-2.0-mini)](https://toai.trade/models/seedance-2.0-mini): Seedance 2.0 Mini（seedance-2.0-mini）生成 4–15 秒、480P / 720P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 1.16 CNY 起（480P）。
- [Seedance 2.5 (seedance-2.5)](https://toai.trade/models/seedance-2.5): Seedance 2.5（seedance-2.5）生成 4–30 秒、480P / 720P / 1080P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 3.39 CNY 起（480P）。

## 文档

- [快速开始](https://toai.trade/docs/quickstart): 创建 API Key，用 curl、Python 或 Node.js 生成第一段 Seedance 视频。
- [鉴权与 API Key](https://toai.trade/docs/authentication): Bearer API Key 及其控制项：模型白名单、消费限额、有效期、频率与并发上限、IP 白名单。
- [模型与能力](https://toai.trade/docs/models): Seedance 模型的生成方式、分辨率、时长、画面比例与素材限制。
- [计价与扣费](https://toai.trade/docs/pricing): 视频 tokens 的计算方式（宽 × 高 × 帧数 ÷ 1024），以及提交时冻结、完成后结算与释放。
- [素材上传与管理](https://toai.trade/docs/assets): 上传图片、视频、音频，或用链接导入私有素材库。
- [人像素材与授权](https://toai.trade/docs/portraits): 虚拟人像入库与真人人像授权，用于参考生视频。
- [创建与查询任务](https://toai.trade/docs/tasks): 创建、查询、列出与取消视频生成任务；任务状态与结果。
- [幂等](https://toai.trade/docs/idempotency): 用 Idempotency-Key 请求头安全地重试创建任务。
- [结果留存](https://toai.trade/docs/results): 生成结果保留多久，以及如何换取新的下载地址。
- [终态通知与验签](https://toai.trade/docs/webhooks): 以 HMAC-SHA256 签名（X-AILink-Signature）的终态通知，至少投递一次并自动重试。
- [错误码](https://toai.trade/docs/errors): 稳定的错误码、HTTP 状态与处理建议。
- [限流与查询频率](https://toai.trade/docs/rate-limits): 请求频率与并发限制，以及推荐的查询间隔。
- [更新记录](https://toai.trade/docs/changelog): 接口与模型目录的变更记录。
- [方舟兼容接口](https://toai.trade/docs/ark): 继续使用火山方舟官方 SDK，只需把 base_url 换成本站。
- [OpenAI 兼容接口](https://toai.trade/docs/openai): 用 OpenAI SDK 的 Videos 接口创建和获取视频。
- [素材管理 AK/SK 接口](https://toai.trade/docs/asset-api): 以 AK/SK 签名、兼容火山引擎的素材管理接口。

## 接口定义

- [OpenAPI 3.1](https://toai.trade/openapi.json): 全部接口、字段与错误码

## 计费

视频 tokens = 输出视频的宽 × 高 × 帧数 ÷ 1024（帧数 = 24 × 秒数 + 1），费用 = tokens ÷ 1,000,000 × 对应分辨率单价。带参考视频时参考视频时长也计入，按含参考视频单价。提交时冻结最大可能费用，完成后按实际用量结算并退回多余部分；失败、取消、超时不收费；成功的任务只结算一次。

### Seedance 2.0 (`seedance-2.0-standard`)

Seedance 2.0（seedance-2.0-standard）生成 4–15 秒、480P / 720P / 1080P / 4K 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 2.33 CNY 起（480P）。

- 分辨率: 480p, 720p, 1080p, 4k
- 画面比例: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
- 时长: 4–15 s (默认 5 s)
- 参考输入上限: 9 张图片, 3 段视频, 3 段音频

| 分辨率 | 含参考视频 | 每百万 tokens (CNY) |
| --- | --- | --- |
| 480P | 否 | 46 |
| 480P | 是 | 28 |
| 720P | 否 | 46 |
| 720P | 是 | 28 |
| 1080P | 否 | 51 |
| 1080P | 是 | 31 |
| 4K | 否 | 26 |
| 4K | 是 | 16 |

### Seedance 2.0 Fast (`seedance-2.0-fast`)

Seedance 2.0 Fast（seedance-2.0-fast）生成 4–15 秒、480P / 720P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 1.87 CNY 起（480P）。

- 分辨率: 480p, 720p
- 画面比例: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
- 时长: 4–15 s (默认 5 s)
- 参考输入上限: 9 张图片, 3 段视频, 3 段音频

| 分辨率 | 含参考视频 | 每百万 tokens (CNY) |
| --- | --- | --- |
| 480P | 否 | 37 |
| 480P | 是 | 22 |
| 720P | 否 | 37 |
| 720P | 是 | 22 |

### Seedance 2.0 Mini (`seedance-2.0-mini`)

Seedance 2.0 Mini（seedance-2.0-mini）生成 4–15 秒、480P / 720P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 1.16 CNY 起（480P）。

- 分辨率: 480p, 720p
- 画面比例: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
- 时长: 4–15 s (默认 5 s)
- 参考输入上限: 9 张图片, 3 段视频, 3 段音频

| 分辨率 | 含参考视频 | 每百万 tokens (CNY) |
| --- | --- | --- |
| 480P | 否 | 23 |
| 480P | 是 | 14 |
| 720P | 否 | 23 |
| 720P | 是 | 14 |

### Seedance 2.5 (`seedance-2.5`)

Seedance 2.5（seedance-2.5）生成 4–30 秒、480P / 720P / 1080P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 3.39 CNY 起（480P）。

- 分辨率: 480p, 720p, 1080p
- 画面比例: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
- 时长: 4–30 s (默认 5 s)
- 参考输入上限: 30 张图片, 10 段视频, 10 段音频

| 分辨率 | 含参考视频 | 每百万 tokens (CNY) |
| --- | --- | --- |
| 480P | 否 | 70 |
| 480P | 是 | 42 |
| 720P | 否 | 70 |
| 720P | 是 | 42 |
| 1080P | 否 | 77 |
| 1080P | 是 | 46 |

## 常见问题

### ToAI 是什么？

ToAI 是 Seedance（字节跳动视频生成模型）的 API 服务：一个 API Key 即可调用，按实际生成的帧数计费，失败不收费。

### 可以用哪些模型？

Seedance 2.0（seedance-2.0-standard）生成 4–15 秒、480P / 720P / 1080P / 4K 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 2.33 CNY 起（480P）。 Seedance 2.0 Fast（seedance-2.0-fast）生成 4–15 秒、480P / 720P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 1.87 CNY 起（480P）。 Seedance 2.0 Mini（seedance-2.0-mini）生成 4–15 秒、480P / 720P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 1.16 CNY 起（480P）。 Seedance 2.5（seedance-2.5）生成 4–30 秒、480P / 720P / 1080P 的视频，支持文生视频、首帧生视频、首尾帧生视频、多模态参考（图片、视频、音频）。可同时生成同步音频。5 秒 16:9 视频 3.39 CNY 起（480P）。

### 一段视频怎么计费？

按视频 tokens 计费：输出视频的宽 × 高 × 帧数 ÷ 1024，乘以对应分辨率每百万 tokens 的单价；带参考视频时，参考视频的时长也计入，按含参考视频的单价计算。例如 Seedance 2.0 生成 5 秒 16:9 480P 视频约 2.33 CNY。失败、取消和超时的任务不收费；提交时按最大可能费用冻结，完成后按实际用量结算，多冻结的部分自动退回。

### 生成失败会收费吗？

不收费。失败、取消和超时的任务都会退回提交时冻结的额度，只有成功的任务按实际用量结算一次。

### 能直接用火山方舟或 OpenAI 的 SDK 吗？

可以。方舟兼容接口地址为 https://api.toai.trade/api/v3，OpenAI Videos 兼容接口地址为 https://api.toai.trade/v1，替换 base_url 和 API Key 即可迁移；平台自己的接口是 https://api.toai.trade/v1/videos/generations。

### 生成的视频保存多久？

7 天。生成结果在交付前转存到本站存储，期间可以随时换取新的下载地址，不受上游 24 小时链接的限制。

### 怎么开通额度？

本站不在线收款：线下付款后由运营录入额度，也可以在“额度与账单”中使用兑换码。请联系运营。

## 接口清单

鉴权：请求头 Authorization: Bearer <API Key>。

- `GET https://api.toai.trade/api/v3/contents/generations/tasks`: List tasks (Ark-compatible). Required key permission: `tasks_read`.
- `POST https://api.toai.trade/api/v3/contents/generations/tasks`: Create a task (Ark-compatible). Required key permission: `generate`.
- `DELETE https://api.toai.trade/api/v3/contents/generations/tasks/{id}`: Cancel a queued task (Ark-compatible). Required key permission: `generate`.
- `GET https://api.toai.trade/api/v3/contents/generations/tasks/{id}`: Get a task (Ark-compatible). Required key permission: `tasks_read`.
- `GET https://api.toai.trade/v1/account/quota`: Account balance and this key's limits
- `GET https://api.toai.trade/v1/asset-groups`: List groups. Required key permission: `assets_read`.
- `POST https://api.toai.trade/v1/asset-groups`: Create a group. Required key permission: `assets_write`.
- `DELETE https://api.toai.trade/v1/asset-groups/{id}`: Delete a group (its assets become ungrouped). Required key permission: `assets_write`.
- `PATCH https://api.toai.trade/v1/asset-groups/{id}`: Edit a group. Required key permission: `assets_write`.
- `GET https://api.toai.trade/v1/assets`: List your assets. Required key permission: `assets_read`.
- `POST https://api.toai.trade/v1/assets`: Create an asset from an upload, a URL or a file. Required key permission: `assets_write`.
- `DELETE https://api.toai.trade/v1/assets/{id}`: Request deletion of an asset and its copies. New tasks can no longer reference it. Running tasks that use it finish first; the file and its copies are removed afterwards. Required key permission: `assets_write`.
- `GET https://api.toai.trade/v1/assets/{id}`: Get an asset (with a 15-minute preview URL). Required key permission: `assets_read`.
- `PATCH https://api.toai.trade/v1/assets/{id}`: Rename an asset or move it to another group. Required key permission: `assets_write`.
- `GET https://api.toai.trade/v1/models`: List models available to this key
- `GET https://api.toai.trade/v1/portrait-authorizations`: List authorizations. Required key permission: `assets_read`.
- `POST https://api.toai.trade/v1/portrait-authorizations`: Start a real-person authorization. Required key permission: `assets_write`.
- `GET https://api.toai.trade/v1/portrait-authorizations/{id}`: Get an authorization. Required key permission: `assets_read`.
- `POST https://api.toai.trade/v1/portrait-authorizations/{id}/grants/{grant}/renew`: New verification link for one route. Required key permission: `assets_write`.
- `POST https://api.toai.trade/v1/uploads`: Start a signed upload to object storage. Files up to 32 MB get one signed PUT URL; larger files get one signed URL per part (part_size bytes). URLs are valid for 2 hours. Required key permission: `assets_write`.
- `POST https://api.toai.trade/v1/uploads/{id}/complete`: Finish an upload. Required key permission: `assets_write`.
- `GET https://api.toai.trade/v1/videos`: List videos (OpenAI-compatible). Required key permission: `tasks_read`.
- `POST https://api.toai.trade/v1/videos`: Create a video (OpenAI-compatible). Required key permission: `generate`.
- `GET https://api.toai.trade/v1/videos/generations`: List tasks. Required key permission: `tasks_read`.
- `POST https://api.toai.trade/v1/videos/generations`: Create a video generation task. Validates the request against the model's capabilities, holds the maximum possible cost and returns at once. Failures after acceptance appear in the task's status and error, never as a different HTTP status. Required key permission: `generate`.
- `GET https://api.toai.trade/v1/videos/generations/{id}`: Get a task: status, result, usage and cost. Required key permission: `tasks_read`.
- `POST https://api.toai.trade/v1/videos/generations/{id}/cancel`: Cancel a task not yet sent upstream. Required key permission: `generate`.
- `GET https://api.toai.trade/v1/videos/{id}`: Get a video (OpenAI-compatible). Required key permission: `tasks_read`.
- `GET https://api.toai.trade/v1/videos/{id}/content`: Download the video or its last frame. Required key permission: `tasks_read`.