API 文档 · 入门
快速开始
四步完成接入,提交第一个视频任务。
aitoken.tools 通过一个平台 API Key 提供 Seedance 视频生成能力。接口是异步的:提交任务立即返回任务 ID,生成完成后通过查询或 Webhook 拿到结果。整个过程只需四步:
- 注册账号并验证邮箱。
- 联系运营开通额度:线下付款后,运营核对单号把额度发放到你的账号。
- 在控制台 · API Key 创建 Key,勾选
tasks:create与tasks:read权限,并选择要使用的模型。 - 调用
POST /v1/videos/generations提交任务,然后用GET /v1/videos/generations/{id}查询结果。
Base URL
本站(国内站)的 API 地址为 https://cn-api.aitoken.tools/v1,计价币种 CNY。国内站与海外站账号、Key、额度互不相通,Key 只能调用签发它的站点。
第一个任务
右侧示例提交一个 5 秒 720p 的文生视频任务。返回 202 Accepted 与任务对象,status 为 queued。billing.reserved_amount 是本次冻结的额度上界,任务结束后按实际用量结算并退回差额。
务必带上 Idempotency-Key
创建任务必须带
Idempotency-Key 请求头。网络超时后用同一个键重试,不会重复建任务或重复扣费。详见幂等。接下来
curl https://cn-api.aitoken.tools/v1/videos/generations \
-H "Authorization: Bearer $AITOKEN_API_KEY" \
-H "Idempotency-Key: order-A1001-v1" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-standard",
"prompt": "镜头缓缓推进,晨雾中的山间小镇",
"duration": 5,
"resolution": "720p",
"ratio": "16:9"
}'