請求排查
AI API 錯誤 429：速率限制、餘額和支出上限
429 是請求限制響應，不能證明提供方發生故障。重試前請檢視提供方的錯誤程式碼、訊息和重試標頭。
簡要回答
429 是請求限制響應，不能證明提供方發生故障。重試前請檢視提供方的錯誤程式碼、訊息和重試標頭。
各提供方文件說明
OpenAI 區分請求頻率限制、積分耗盡和組織／專案限制。請檢查 error.code；對計費或用量限制重試不會恢復訪問。
Claude 對請求限速和部分支出上限使用 rate_limit_error。使用等級支出上限響應沒有 retry-after 響應頭。流量快速增長也可能觸發請求限速。
Gemini 將 429 RESOURCE_EXHAUSTED 列入可能適合指數退避的錯誤。在將限制視為暫時問題前，應檢查錯誤詳情。
建議的應用處理方式
對於暫時請求限速，降低請求併發，遵循已提供的重試延遲，並設定最大嘗試次數和總截止時間。考慮 SDK 已執行的重試。缺少重試響應頭本身不能確認原因。
保留脫敏後的錯誤正文與請求 ID。錯誤表示積分或支出限制時，請私下檢查賬戶配置，不要釋出憑據。將對應 API 狀態範圍與請求證據對照。
相關服務頁面
每個條目顯示自己的收集覆蓋。連結到服務不一定表示自動收集。
編輯稽核日期適用於本指南。實時報告收集時間顯示在服務頁面。