概覽
API 的使用受速率限制約束。這些限制會規範指定期間內的請求數、Token 數或其他用量。
429 回應可能表示暫時觸及速率限制、預付餘額已用盡，或已達支出或用量上限。重試或變更帳務設定前，請先查看錯誤詳細資訊。
找出原因
請閱讀錯誤訊息，以及提供的 error.code（如有）。帳務相關錯誤的 error.type 仍可能使用較廣泛的 insufficient_quota 值。
| 錯誤或錯誤代碼 | 含義 | 處理方式 |
| 請求數或 Token 數已達速率限制 | 請求已超出適用的速率限制。 | 控制請求發送頻率，並遵循下方的重試指引。 |
| credit_balance_exhausted | 組織的預付點數已用盡。 | 在 API 帳務設定中加購點數。 |
| organization_usage_limit_exceeded | 組織已達 OpenAI 指定的用量上限。 | 申請提高核准的用量上限。 |
| organization_spend_limit_exceeded | 組織已達強制執行的支出上限。 | 提高或移除上限，或等待每月重設。 |
| project_spend_limit_exceeded | 專案已達強制執行的支出上限。 | 提高或移除專案上限，或等待每月重設。 |
遇到帳務、支出或配額錯誤時，重試並無法恢復存取。請先處理錯誤所指出的餘額或上限問題。強制執行的支出上限變更可能需要一些時間才會生效。
變更支出上限需要具備管理相關組織或專案設定的權限。如果你沒有權限，請洽詢負責管理這些設定的人員。
如需了解如何購買預付點數，請參閱：設定及管理 API 預付計費。
如需了解各種支出控管方式，請參閱 API 支出上限指南。
查看適用的速率限制
前往組織的「限制」頁面，查看目前的用量等級和限制。
速率限制可套用於組織和專案層級。這些並非個別使用者的專屬額度。限制也會因模型而異，部分模型系列則共用同一限額。
請確認錯誤指出的是哪一項限制。例如，每分鐘請求數和每分鐘 Token 數是兩項獨立的限制。你可能已達其中一項上限，卻仍未達另一項。
查看圖像生成 API 的限制
圖像生成 API 的速率限制取決於模型和你的用量等級。在模型頁面選取你使用的模型，即可查看相關限制。
如需設定說明，請參閱圖像生成開發人員指南。如需進一步了解用量等級，請參閱 API 速率限制指南。
確認請求使用的組織
如果你隸屬多個組織，請確認請求使用的是預期的組織和專案。
如果你的 API 金鑰使用預設組織，請檢查預設組織設定。不同組織的計費安排和用量等級可能不同。
減少暫時性的速率限制錯誤
控制請求發送頻率，避免突發大量請求
將請求分散在不同時間發送，而非一次發送大量請求。
速率限制可能會以比顯示間隔更短的時間區間執行。例如，每分鐘 60 次請求的限制，也可能以每 1 秒為單位執行。因此，即使平均用量看似低於每分鐘限額，短時間內突發的大量請求仍可能觸發錯誤。
過長的提示詞，以及設得過高、超出實際需要的輸出 Token 額度，也可能導致 Token 速率限制錯誤。
稍候再重試
若遇到暫時性的速率限制錯誤：
檢查是否有 Retry-After 回應標頭。
如果標頭包含有效的延遲時間，請至少等待該段時間後再重試。
如果標頭不存在或無效，請使用帶有隨機抖動的指數退避：每次嘗試失敗後，以指數方式增加等待時間，並額外加入一小段隨機延遲。
請同時限制重試次數和重試所花費的總時間。
OpenAI 官方 SDK 已會針對符合條件的速率限制錯誤自動重試，並在有 Retry-After 標頭時遵循其中指定的等待時間。新增另一個重試迴圈前，請先將這些自動重試納入考量。
失敗的請求也會計入每分鐘限額。持續重送相同請求可能會讓問題持續更久。
如需實作指引和範例，請參閱 API 速率限制指南。在應用程式中使用任何第三方重試程式庫之前，請先進行評估。
檢視提示詞與輸出長度
從提示詞中移除不必要的指令、重複的背景資訊和範例。測試修改後的提示詞，確認仍能產生你需要的結果。
使用端點和模型支援的輸出 Token 參數：
Chat Completions 使用 max_completion_tokens。
Responses 使用 max_output_tokens。
避免將額度設得遠高於請求的實際需求。這些參數涵蓋推理 Token 和可見輸出，因此使用推理模型時，請為兩者都預留額度。
查看你的用量等級
如果減少突發請求並檢視 Token 用量後，錯誤仍持續發生，請前往「限制」頁面，查看有哪些提高限額的方式。
當組織累計購買的點數達到 Build、Launch 和 Grow 的門檻時，付費用量等級就會自動升級。較高的等級通常提供較高的速率限制。如需了解各等級的要求，請參閱 API 速率限制指南。
你獲准的每月用量上限，與請求數和 Token 數的速率限制彼此獨立。提高其中一項，不代表另一項也已變更。
如果問題持續發生
尋求進一步協助之前
請備妥完整的錯誤訊息、所有錯誤代碼、相關請求 ID、錯誤發生的時間與時區，以及帳戶中顯示的相關限制。記錄你已嘗試過的步驟。
聯絡 OpenAI 支援團隊
如果查看錯誤所指出的限制後仍無法解決問題，請透過說明中心聯絡 OpenAI 支援團隊。請勿提供 API 金鑰或其他驗證機密資訊。