LogoLogoAPI 文件
LogoLogoAPI 文件
首頁
總覽驗證與冪等性影像生成影像編輯影像轉換任務與限時等待點數錯誤速率限制與併發API 變更紀錄
API 文件

錯誤

穩定的錯誤結構、錯誤碼與 HTTP 狀態

錯誤採用固定的封裝結構,且絕不含非公開的診斷資訊:

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request is invalid.",
    "request_id": "req_012345"
  }
}
HTTP錯誤碼意義
400INVALID_REQUEST主體、表單欄位、標頭或影像不合法
400CONTENT_POLICY_VIOLATION此請求無法處理
401UNAUTHORIZEDAPI 金鑰缺少或無效
402INSUFFICIENT_CREDITS可用餘額不足
403FORBIDDEN缺少所需權限範圍或 Beta 存取權
404JOB_NOT_FOUND任務不存在,或屬於其他帳號
409IDEMPOTENCY_CONFLICT相同金鑰被用於不同內容
409JOB_CANCELED任務已被取消
429RATE_LIMIT_EXCEEDED超出請求上限
500JOB_FAILED影像任務無法完成
500INTERNAL_ERROR請求無法完成

上傳大小超限會以 HTTP 413 搭配 INVALID_REQUEST 回傳。429 與尚未進入終態的 任務,請依文件所述的延遲時間視為可重試。其他錯誤請修改請求,或附上 request_id 聯絡技術支援;不要用給人看的訊息作為程式邏輯的判斷依據。

點數

讀取餘額並理解預留機制

速率限制與併發

每把金鑰的請求上限與每個帳號的任務上限