錯誤總表

除了檔案下載(成功時回傳檔案本身)以外,所有錯誤回應都是 JSON 格式,至少包含 message 欄位。422 會另外包含 errors 欄位,以欄位名稱為鍵,列出該欄位的錯誤訊息。

狀態碼	意思	常見原因
401	驗證失敗	沒帶 X-Api-Key、金鑰不存在或已撤銷、試用金鑰的額度已到期(見〈驗證方式〉)
402	積分不足	建立任務時,付費餘額或試用額度不夠(見〈積分與計費〉)
404	找不到,或不屬於你	查詢或下載的任務不存在、不屬於這把金鑰的帳號;下載時的 key 不在任務的 result 裡(見〈任務查詢與取件〉)
410	已過期或已刪除	下載時,結果檔案已超過保存期限或已被刪除(見〈任務查詢與取件〉)
422	參數有誤	欄位驗證失敗;model 不存在(Unknown model alias: {model});模型目前未開放(Model {model} is not available);images 的格式、base64、圖片類型或大小不正確
429	請求太多	超過金鑰的每分鐘或每日上限(見〈驗證方式〉);排隊中的同類型任務太多(回應會帶 Retry-After header)

任務失敗的 error_code

任務建立成功(201)後才發生的失敗,不會用 HTTP 狀態碼回應,而是任務 status 變成 30,並帶上 error_code 和 error_message(見〈任務查詢與取件〉)。失敗的任務都已全額退款。

error_code	原因
face_age_minor	圖中有未成年人,見〈生成前年齡檢查〉
face_age_uncertain	無法確認圖中人物已成年,可以帶 age_declared: true 重新送出,見〈生成前年齡檢查〉
face_check_failed	年齡檢查服務暫時無法使用,請稍後再送
service_unavailable	這個模型目前資源不足,任務還沒開始處理,請稍後再送

範例

沒帶 API 金鑰(401):

{ "message": "API key required." }

積分不足(402):

{ "message": "Insufficient credits to complete this charge." }

任務不存在或不屬於你(404):

{ "message": "Task not found." }

結果檔案已超過保存期限(410):

{ "message": "File has expired." }

欄位驗證失敗(422):

{
  "message": "The duration field is required.",
  "errors": { "duration": ["The duration field is required."] }
}

排隊中的任務太多(429):

{ "message": "Too many pending tasks of this type; please retry later." }

回應會同時帶 Retry-After header(秒數),建議等這段時間後再重試。