Codex API 報429：分清速率、餘額與支出限制

Codex 請求返回429，先別急着判斷餘額不夠。相同的 HTTP 狀態可能對應請求太密，也可能指向餘額或不同層級的限制。

先確認錯誤來自哪家服務，再看具體錯誤正文。下面只整理 OpenAI 官方 API 的排查方向。

先拿到具體 code

錯誤依據	優先核對
請求過快、`slow_down` 等速率問題	請求頻率、併發和返回的等待指示
`credit_balance_exhausted`	組織預付餘額
`project_spend_limit_exceeded`	當前項目支出限制
`organization_spend_limit_exceeded`	當前組織支出限制
`organization_usage_limit_exceeded`	服務方分配的組織用量上限

error.type 即使籠統寫着 insufficient_quota，也應繼續檢查 error.code，不要只截最後一句提示。OpenAI 錯誤碼文件

減少併發和請求頻率。響應有 Retry-After 時，按它等待，再受控重試。連續手動點「重試」可能繼續增加請求量，不能保證恢復得更快。

確認使用的是哪個項目、組織和計費路徑，再查看餘額、用量與限制。重複請求不會恢復這類額度。是否調整預算或上限，應根據實際需要決定，不要把「調高限制」當成所有429的預設處理。

檢查 Key、所屬項目或組織、權限，以及是否存在 IP 允許列表限制。CLI 本地顯示已登入，不能替代一次在線請求驗證。官方認證說明

求助時保留客戶端版本、目標服務與模型、狀態碼、具體 code、已遮去敏感資料的錯誤內容、發生時間和時區。有請求 ID 也一起保留，方便關聯日誌；不要附帶真實 Key 或 Authorization。

原筆記發表於2026年10月23日；原稿於10月27日複核官方文件後整理。本文是文件速查，沒有復現付費請求錯誤，也不能保證所有429都屬於表中某一項。

香港繁體版整理日期：2026年10月28日。原文引用的產品說明核對截至2026年10月27日；原實驗日期與範圍保留於文中。