概覽
API 帳務或配額錯誤可能表示您已達到核准的用量限制、設定的支出限制,或已用完預付點數。請先查看錯誤,再變更設定。
識別錯誤
查看 API 回應中的 error.code。帳務相關錯誤仍可能使用較廣泛的 error.type 值 insufficient_quota。
| 錯誤代碼 | 含義 | 後續步驟 |
| organization_usage_limit_exceeded | 您的組織已達 OpenAI 核准的用量限制。 | 查看核准的限制以及提高限制的選項。 |
| organization_spend_limit_exceeded | 您的組織已達到設定的支出硬性限制。 | 查看組織的支出控制設定。 |
| project_spend_limit_exceeded | 您的專案已達到設定的支出硬性限制。 | 查看該專案的支出控制設定。 |
| credit_balance_exhausted | 您的組織已無剩餘的預付點數。 | 將點數新增至您的 API 餘額。 |
若未處理相關點數或限制,重試這些錯誤並不會恢復存取權。如需詳細資訊,請參閱 API 錯誤代碼指南。
查看核准的用量限制
前往組織的 限制頁面,查看目前核准的每月用量限制和用量層級。
隨著 API 支出增加,OpenAI 會自動將您的組織移至更高的用量層級。這通常會提高大多數模型的速率限制。請以組織所顯示的限制為準,不要假設每個帳戶都有相同的每月額度。
如需層級詳細資訊,請參閱 API 速率限制指南。
查看已設定的支出控制
支出警示會傳送通知,但不會停止 API 流量。追蹤的支出達到設定金額時,支出硬性限制可能會阻止受影響的請求。
組織和專案限制都可能適用。組織限制涵蓋其專案;專案限制則涵蓋計費至該專案的流量。這些控制設定與 OpenAI 核准的用量限制互不相同。
如果錯誤是由硬性限制所致,而支出應繼續,具備相關設定管理權限的人員可以提高或移除該限制。否則,限制會在下一個每月週期重設。變更與限制執行並非即時生效,因此記錄的支出可能會略微超過設定金額。
如需設定與操作說明,請參閱 API 支出限制指南。
查看預付餘額
如果預付點數已用完,請前往 API 帳務入口網站,並視頁面顯示選取 Buy credits 或 Add to credit balance,以購買更多點數。更新後的餘額可能需要幾分鐘才會顯示。
如需設定與儲值指引,請參閱:設定預付帳務。
確認錯誤是否為速率限制錯誤
請求與 Token 速率限制會控制您使用 API 的速度。這些限制不同於每月用量限制、支出控制設定和預付餘額。
若遇到請求或 Token 速率限制錯誤,請參閱:API 速率限制錯誤疑難排解。
如果問題持續發生
升級處理前
請準備好錯誤訊息與代碼、錯誤發生時間和您的時區,以及任何相關的請求 ID。請移除所分享螢幕截圖或程式碼中的敏感資訊。
聯絡 OpenAI 支援團隊
如果您的需求超出組織可用的限制、有特殊使用案例,或處理錯誤原因後問題仍持續發生,請使用說明中心的聊天小工具聯絡 OpenAI 支援團隊。
如需聯絡方式與應提供的資訊,請參閱:聯絡支援團隊。
