錯誤

失敗的請求傳回帶有 error 物件的 JSON。 HTTP狀態是第一個訊號； message 和 code 欄位命名實際故障。

JSON

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

常用狀態碼

狀態	典型原因
400	無效的 JSON、不受支援的欄位或模型的錯誤端點
401	API 金鑰缺失或無效
403	金鑰不能使用該模型或群組
404	未知路徑或缺少任務
429	速率限制
499	用戶端取消了請求
5xx	服務供應商或網關故障

發送到錯誤協定的圖像和視訊請求返回 400 和 unsupported_endpoint，並命名所需的 API。靜默協定轉換僅適用於文字模型。

較長的診斷、重試和回退屬於主站點上的技術文章，從 AI API 錯誤故障排除 開始。