API 文件 · 任務
非同步任務與狀態
狀態機、失敗碼與請求欄位。
POST /v1/videos/generations 驗證通過後會立即回傳 202 與任務物件。受理後才發生的失敗不會改變已回傳的 202，只會反映在任務物件的 error 欄位中。帳號或 Key 同時進行中的任務數達到上限時回傳 429 rate_limited（Retry-After: 10）。
任務狀態
| status | 說明 |
|---|---|
| 排隊中 | 已受理，等待處理 |
| 準備素材 | 正在將輸入素材準備到處理通道 |
| 生成中 | 生成中 |
| 恢復處理中 | 目前通道發生異常，平台正透過另一條通道恢復處理；任務 ID 不變 |
| 核查中 | 平台正在核對上游的最終結果，避免重複生成或重複計費 |
| 結算中 | 儲存結果並結算 |
| 成功 | 成功，result 中含影片網址；終態 |
| 失敗 | 失敗，error 中含失敗碼與說明；終態 |
只有 succeeded 與 failed 是終態。請勿依賴中間狀態的順序，平台可能略過某些狀態，或在恢復時從 running 回到 recovering。
失敗碼
| error.code | 建議做法 |
|---|---|
no_available_channel | 本站目前沒有可用的處理線路。請稍後以新的冪等鍵重新送出。 |
upstream_status_unknown | 平台無法確認生成結果。請查看費用明細，並以新的冪等鍵重新送出。 |
task_deadline_exceeded | 任務超過處理時限仍未完成。可降低時長或解析度後重新送出。 |
content_rejected | 提示詞或生成內容未通過內容審核。請調整描述後再送出，重複送出相同內容仍會失敗。 |
asset_rejected | 輸入素材未通過審核或格式檢查。請更換素材後重試。 |
invalid_parameter | 不支援此參數組合。請對照模型能力表檢查解析度、比例、時長與輸入數量。 |
account_suspended | 帳號已遭停用，請聯絡營運團隊。 |
result_unavailable | 無法取回生成結果。請重新送出。 |
internal_error | 平台內部錯誤。請稍後重試；若持續發生，請附上請求 ID 聯絡營運團隊。 |
請求欄位
| 欄位 | 說明 |
|---|---|
model | 必填，模型 ID；必須在 Key 的白名單中，且帳號已開通（否則回傳 403 permission_denied） |
prompt | 提示詞；不帶任何 inputs 的文字生成影片必填，長度上限請見能力表 |
inputs | 輸入素材陣列 { type, asset_id, role }，最多 20 個；首幀、尾幀不能與參考類角色同時使用 |
duration | 必填，時長（秒）；能力表允許時可傳 -1 由模型自動決定 |
resolution / ratio | 必填，解析度與畫面比例，可用值請見能力表 |
max_budget | 選填，單一任務的預算上限（字串金額）；凍結上限超過此值時回傳 402 quota_exceeded |
callback_url | 選填，任務進入終態時推送 Webhook |
metadata | 選填，字串鍵值對，原樣回傳；最多 32 筆，鍵 ≤ 64 字元、值 ≤ 512 字元，合計 ≤ 8 KiB |
provider_options | 選填，模型特有參數（扁平鍵值，例如 seed），可用的鍵與型別請見能力表；值為布林、整數或不超過 32 字元的字串 |
fallback_models | 選填，跨模型備援：主模型所有線路都不可用時依序改用這些模型（最多 3 個）。依實際模型計費，凍結額取候選中最貴的一個；回傳的 model_used 標明實際模型 |
allow_fallback | 選填，為 true 時使用平台為該模型設定的預設備援鏈（模型清單的 default_fallbacks）；不傳或 false 時不備援 |
結果欄位
任務成功後 result 包含 video_url、last_frame_url、url_expires_at 與 retained_until，有效期限請見結果保留。若帳號已開通回傳上游原始連結，還會帶有 upstream_video_url 與 upstream_url_expires_at（上游原始連結通常在生成完成後 24 小時內有效）。
參考圖 + 參考音訊
POST https://cn-api.aitoken.tools/v1/videos/generations
{
"model": "seedance-2.0-standard",
"prompt": "人物看向鏡頭微笑，背景虛化",
"inputs": [
{ "type": "image", "asset_id": "asset_xxx", "role": "reference_image" },
{ "type": "audio", "asset_id": "asset_yyy", "role": "reference_audio" }
],
"duration": 8,
"resolution": "1080p",
"ratio": "9:16",
"max_budget": "30.000000",
"callback_url": "https://example.com/hooks/video",
"metadata": { "order_id": "A-1001" }
}