# 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): 全部接口、字段与错误码
- [完整说明](https://toai.trade/llms-full.txt): 模型参数、价目表、接口清单与常见问题

## Optional

- [价格](https://toai.trade/pricing)
- [常见问题](https://toai.trade/#faq)