Authorization: Bearer $MIXROUTE_API_KEY 認證,請求體為 JSON。模型 ID 位於 URL 中,不在請求體中重複傳 model;不新增 /v1,也不使用 metadata 包裝。
支援模型
只使用賬戶模型列表中可用的完整型號。端點與模型必須匹配:例如
kling-3.0-omni 和 kling-o1 走 omni-video,不能走普通文生/圖生端點;動作控制使用 kling-3.0 或 kling-2.6,不是獨立的 motion 型號。
呼叫流程
- 按所需功能選擇生成端點,提交原生請求體。
- 檢查 HTTP 狀態和 JSON
code,code=0表示請求成功。 - 儲存提交響應中的
data.id,每次只查詢一個閘道器任務 ID。 - 任務
succeeded後讀取data[0].outputs中type=video的url。 - 讀取結果 CDN 時不要攜帶 MixRoute Key。提交超時不代表沒有建立任務,不要自動重複提交。
通用選項
預設值與引數層級
閘道器省略值處理:settings.resolution 補 720p;除動作控制外,settings.duration 補 5。文生影片預設畫幅為 16:9。圖生、Omni、動作控制的提示詞放在 contents 的 type=prompt 項中;只有文生影片使用頂層 prompt。顯式填寫影響計費的引數,尤其是 2.6 原生音訊所需的 1080p。
引數名和列舉值區分大小寫。閘道器不會把超出列舉的值靜默改為另一規格;各型號的引數範圍仍須滿足對應介面限制。Element 和 voice ID 必須可被實際路由的上游賬戶訪問,不能假設個人可靈賬戶裡的資產自動共享。
計費
以下為美元/生成秒的基礎單價。最終費用以 模型廣場 當前定價、賬戶分組倍率和控制台賬單為準;不包含資源包或賬戶專屬折扣。
提交時預扣,完成後按
outputs[].duration 的實際生成秒數結算,保留小數秒而非僅按請求的整數時長。動作控制按 15 秒預扣,完成後按實際輸出時長多退少補;失敗或超時任務退回預扣額度。原生響應中的 billing 為可選上游欄位,不能當作 MixRoute 最終實扣憑證。不支援 不代表免費。
任務狀態、失敗原因和完整輪詢示例見 查詢 Kling 任務。