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

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

作者：IsAnythingDown. 核對於 2026-10-06.

規範頁面： https://isanythingdown.com/zh-tw/guides/ai-api-error-codes

## 簡要回答

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

## 從錯誤類別開始

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

| 你看到的內容 | 首先檢查 | 不能確認什麼 |
| --- | --- | --- |
| 400 / 404 / 413 | 請求格式、端點、資源及大小；請讀取提供方錯誤 | 一般服務故障 |
| 401 / 403 | 憑據、訪問許可權與提供方特定限制 | 所有使用者都無法訪問 |
| 429 | 限速響應頭、配額、積分與支出限制 | 立即重試就會成功 |
| 500 / 503 / 529 | 提供方錯誤詳情與相關官方元件 | 已確認的全域性事件 |
| 超時 / 連線錯誤 | 客戶端截止時間、DNS、TLS、代理及請求時長 | 哪一方造成失敗 |
- [OpenAI API 錯誤碼](https://developers.openai.com/api/docs/guides/error-codes)
- [Claude API 錯誤](https://platform.claude.com/docs/en/api/errors)
- [Gemini API 排查](https://ai.google.dev/gemini-api/docs/troubleshooting)

## OpenAI：429 可能對應不同限制

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

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

- [OpenAI API 錯誤碼](https://developers.openai.com/api/docs/guides/error-codes)
- [OpenAI API 元件報告](https://isanythingdown.com/zh-tw/services/openai)

## Claude：過載與支出上限不同

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

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

- [Claude API 錯誤](https://platform.claude.com/docs/en/api/errors)

## Gemini：核對開發者端點

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

- [Gemini API 排查](https://ai.google.dev/gemini-api/docs/troubleshooting)
- [Gemini API / AI Studio 官方狀態](https://aistudio.google.com/status)

## 為重試設定預算

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

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

- [OpenAI API 錯誤碼](https://developers.openai.com/api/docs/guides/error-codes)
- [Gemini API 排查](https://ai.google.dev/gemini-api/docs/troubleshooting)

## 排查具體響應

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

- [AI API 錯誤 429](https://isanythingdown.com/zh-tw/guides/ai-api-error-429)
- [AI API 錯誤 500](https://isanythingdown.com/zh-tw/guides/ai-api-error-500)
- [AI API 錯誤 503](https://isanythingdown.com/zh-tw/guides/ai-api-error-503)
- [AI API 錯誤 529](https://isanythingdown.com/zh-tw/guides/ai-api-error-529)

## 相關服務頁面

- [OpenAI API](https://isanythingdown.com/zh-tw/services/openai)
- [Claude](https://isanythingdown.com/zh-tw/services/claude)
- [Gemini API / AI Studio](https://isanythingdown.com/zh-tw/services/gemini-api)
- [OpenRouter](https://isanythingdown.com/zh-tw/services/openrouter)

每個條目顯示自己的收集覆蓋。連結到服務不一定表示自動收集。

編輯稽核日期適用於本指南。實時報告收集時間顯示在服務頁面。