限流 429 api proxy
Error 429 Too Many Requests
連續 429 多半是上游帳號池限流、冷卻或額度耗盡。先讓服務商換號、換線路或換模型，再用最小請求排除本地並發、餘額和重試循環問題。
錯誤摘要
報錯：exceeded retry limit, last status: 429 Too Many Requests, request id: <request-id>。AI 中轉站裡連續 429 多半是上游帳號池限流、冷卻或額度耗盡，先讓服務商換號、換線路或換模型。
#error 429
#429 too many requests
#openai api 429
#claude code 429
#codex 429
#exceeded retry limit 429
這個錯誤是什麼意思
Error 429 表示服務端理解了請求，但目前不願意繼續處理，因為請求頻率、並發、token 消耗或帳號額度觸發了限制。
在 AI 中轉站裡，重點看中轉站背後的上游帳號池，而不是反覆重試同一個 API Key。只要帳號池已經冷卻或耗盡，繼續重試只會把 429 放大。
常見原因
- 中轉站背後的上游帳號池觸發限流、進入冷卻，或可調度帳號已經沒有可用額度。
- 目前模型通道沒有可用計費、模型級限制被打滿，或該線路暫時沒有健康帳號。
- 中轉站對你的 API Key 做了限流，即使其他帳號池或上游官方 API 還有容量，也可能返回 429。
- Claude Code、Codex、Cursor 或其他工具可能會自動重試失敗請求，把一次失敗變成很多次請求。
- 高上下文 prompt、串流任務、批處理任務或 coding agent 循環可能比普通聊天更快消耗 token。
AI 中轉站報 429 怎麼排查
先用相同的 Base URL、API Key 和模型名發一個最小請求。如果最小請求也返回 429，問題更可能在額度、計費、provider 限制或中轉站限流。
如果最小請求正常，但 coding tool 失敗，重點檢查並發和重試循環。Coding agent 在讀文件、調用工具、恢復失敗步驟時，可能快速發出很多請求。
AI 中轉站報 429 怎麼解決
- 先等待再重試。如果回應裡有
Retry-Afterheader，按它給出的時間等待，不要立刻重複發送同一個請求。 - 檢查服務商控制台裡的餘額、計費狀態、每日額度、請求限制和模型級限制。
- 確認目前中轉站方案或 API Key 支援的並發數上限，再降低並發、減少 max output tokens、縮短 prompt，避免多個 coding agent 會話共用同一個 API Key 同時跑。
- 如果目前 Claude Code、Codex 或 Cursor 會話連續出現 429，但最小請求本身正常，可以先停止目前任務，等待一段時間後新開一個對話或新會話重試。
- 如果 429 持續出現，聯絡中轉站售後客服，並附上報錯時間、模型名、Base URL、請求工具和完整錯誤資訊，讓客服確認是否是帳號池、額度或線路限流。