API 文件 · 入門
快速開始
四個步驟完成串接,送出第一個影片任務。
aitoken.tools 透過一組平台 API Key 提供 Seedance 影片生成能力。API 採非同步設計:送出任務後立即回傳任務 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 的文字生成影片任務。API 回傳 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"
}'