錯誤 · openai-api
OpenAI API 429：先區分速率限制與額度問題
依官方錯誤碼與回應標頭判斷 API 429，不要誤當成 Codex 方案額度用完。
最後核驗：
直接答案
HTTP 429 本身不能證明 ChatGPT 或 Codex 額度已用完。請檢查 error.code 與回應標頭；slow_down 表示請求增加過快，應遵循 Retry-After 並降低速率。
適用範圍
適用於使用 API Key 呼叫 OpenAI API 的應用，不適用於 ChatGPT 方案內的 Codex 用量提示。
操作步驟
- 1確認請求使用 API Key，而非 ChatGPT 方案額度。
- 2記錄 HTTP 狀態、error.code 與 x-request-id，不要記錄 API Key。
- 3若為 slow_down，至少等待 Retry-After 指定的時間，並加入隨機退避。
- 4檢查 x-ratelimit-remaining-* 與 x-ratelimit-reset-*，區分請求數和 Token 限制。
- 5針對餘額、帳單或需人工處理的錯誤，不要無限重試。
常見誤區
- 所有 429 都會在同一個固定時間恢復。
- 立即重試會更快恢復；失敗請求也可能計入限制。
下一步
保留脫敏後的錯誤碼與標頭，再依實際錯誤選擇等待、降速或檢查帳單。
查看最新來源訊號 →