錯誤與重試

錯誤格式

{
  "error": {
    "code": "invalid_parameters",
    "message": "Unsupported resolution."
  }
}

錯誤使用 application/json 和相應 HTTP 狀態。根據 error.code 判斷，不依賴提示文字。

影片和圖片建立請求必須帶有 Idempotency-Key，長度 16–128，僅包含字母、數字、底線或連字號。將其隨業務操作持久儲存。同識別碼和請求本文重放原任務，不重複扣費；參數變更回傳 409 idempotency_conflict。重試和查詢必須使用原 API 金鑰。

HTTP	Code	處理
401	`invalid_api_key`	檢查或更新金鑰。
403	`api_key_upgrade_required`	建立新金鑰。
403	`server_side_only`	改為伺服器端呼叫。
403	`paid_account_required`	需要有效付費訂閱或購買點數。
404	`generation_not_found`	檢查 ID 和原金鑰。
409	`idempotency_conflict`	還原原請求本文。
409	`cost_limit_exceeded`	核對報價和最高扣費限制。
413	`request_too_large`	減少請求本文大小。
422	`invalid_parameters`	根據模型目錄修正參數。
429	`rate_limit_exceeded / concurrency_limit_exceeded / daily_spend_limit_exceeded`	遵循 Retry-After 和帳戶限額。
503	`api_unavailable / service_unavailable`	退避後重試原請求。

網路錯誤、429 和 503 使用退避策略，保留原請求識別碼。409 generation_rejected 明確表示提交前被拒絕，解決原因後才建立新請求。結果未知的逾時不能自動變成新生成。邊緣防火牆每 IP 每分鐘 120 次，超限可能回傳非 JSON 的 403，請等待視窗重設。