請求排查

AI API 錯誤：401、429、5xx 和超時

區分 OpenAI、Claude 和 Gemini API 的身份認證、配額、請求限速與暫時失敗。決定重試前先使用錯誤詳情。

作者：IsAnythingDown已核對 2026-10-06閱讀 Markdown ↗

簡要回答

API 錯誤本身不能確認提供方故障。請檢視提供方的錯誤正文和請求 ID，再核對對應狀態元件。認證和計費問題需要調整配置；臨時失敗可能適合有限重試。

使用此表選擇首次檢查。確切含義和措施取決於提供方、端點和錯誤正文。

檢查 error.code，而不只看 HTTP 429。OpenAI 區分請求頻率限制、積分耗盡和組織／專案限制。計費與配額失敗不會透過重複重試解決。對於暫時請求限速或過載，應遵循已提供的 Retry-After 並限制重試。

API 元件請使用 OpenAI API 條目。ChatGPT 應用條目不能確認 API 請求結果或具體 GPT 模型健康。

Claude 文件將 529 定義為過載、401 為身份認證失敗、403 為許可權失敗。429 可能表示請求限速或支出上限。使用等級支出上限對應的 429 沒有 Retry-After 響應頭，會持續失敗直至訪問恢復。選擇重試策略前應讀取完整錯誤。

Claude 文件說明流式響應可能在 HTTP 200 之後發生錯誤。應檢查流是否完成及錯誤事件；僅收到響應頭不能確認生成成功。

Google 對暫時失敗建議採用帶隨機延遲的有界指數退避。也應檢查 API 版本、模型及支援的引數。請檢視開發者 API 自己的報告；Gemini 應用事件流不覆蓋 Gemini API 或 AI Studio 請求。

作為應用設計選擇，應同時設定最大嘗試次數和總時間預算。計入 SDK 已執行的重試。對於提供方認定為臨時性的錯誤，採用帶隨機抖動的指數退避延遲，並遵守適用的重試標頭。

重放中斷請求前，請核對它是否已經產生輸出、費用或下游操作。重試模型請求與重複 Agent 的工具操作是不同決策。保留請求 ID 以便排查，並在允許的預算耗盡後停止自動重試。

請使用針對請求所返回錯誤的專用指南。這些頁面解釋請求失敗，不監測賬戶限額。