# AI API 錯誤 429：速率限制、餘額和支出上限

429 是請求限制響應，不能證明提供方發生故障。重試前請檢視提供方的錯誤程式碼、訊息和重試標頭。

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

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

## 簡要回答

429 是請求限制響應，不能證明提供方發生故障。重試前請檢視提供方的錯誤程式碼、訊息和重試標頭。

## 各提供方文件說明

OpenAI 區分請求頻率限制、積分耗盡和組織／專案限制。請檢查 error.code；對計費或用量限制重試不會恢復訪問。

Claude 對請求限速和部分支出上限使用 rate_limit_error。使用等級支出上限響應沒有 retry-after 響應頭。流量快速增長也可能觸發請求限速。

Gemini 將 429 RESOURCE_EXHAUSTED 列入可能適合指數退避的錯誤。在將限制視為暫時問題前，應檢查錯誤詳情。

- [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)

## 建議的應用處理方式

對於暫時請求限速，降低請求併發，遵循已提供的重試延遲，並設定最大嘗試次數和總截止時間。考慮 SDK 已執行的重試。缺少重試響應頭本身不能確認原因。

保留脫敏後的錯誤正文與請求 ID。錯誤表示積分或支出限制時，請私下檢查賬戶配置，不要釋出憑據。將對應 API 狀態範圍與請求證據對照。

- [如何理解 AI API 錯誤](https://isanythingdown.com/zh-tw/guides/ai-api-error-codes)

## 相關服務頁面

- [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)

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

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