For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽

支出上限

為組織和專案設定每月 API 支出上限。

使用支出警示追蹤每月 API 費用。若要在追蹤到的支出達到設定金額後停止流量,請為組織或個別專案啟用強制支出上限。

強制支出上限可能會中斷正式環境的流量。當追蹤到的支出達到 適用的強制上限時,受影響的 API 請求會傳回 429 錯誤,錯誤碼為 organization_spend_limit_exceededproject_spend_limit_exceeded。 上限並非即時生效,因此記錄的支出可能會略微超過 設定的金額。

選擇支出控管方式

支出警示與強制支出上限的作用不同:

控管方式達到設定金額時的行為適用目的
支出警示傳送通知;API 流量不受影響追蹤支出,同時維持流量不中斷
強制支出上限受影響的 API 請求會傳回 429 錯誤強制執行組織或專案的每月支出上限

支出警示不會強制限制支出。新增強制支出上限後,警示仍會保持啟用,因此您可以利用警示,在強制上限中斷流量前收到通知。

OpenAI 也會根據組織的使用量級別,為其核准每月的使用量上限。這項由 OpenAI 核准的使用量上限,與您自行設定的支出上限各自獨立。

設定支出上限

您需要具備管理相關組織或專案設定的權限。詳情請參閱 API 平台權限

  1. 前往組織上限
  2. 支出中,選取 編輯支出上限
  3. 輸入 每月支出上限
  4. 若要讓 API 在組織達到上限後傳回失敗回應,請開啟 強制執行上限
  5. 選取 儲存

瞭解強制上限的運作方式

組織和專案的強制上限可以同時適用於同一個請求:

  • 組織的強制上限適用於組織內所有專案的 API 流量。
  • 專案的強制上限僅適用於費用計入該專案的 API 流量。
  • 達到組織的強制上限時,會傳回 429 錯誤,錯誤碼為 organization_spend_limit_exceeded
  • 達到專案的強制上限時,會傳回 429 錯誤,錯誤碼為 project_spend_limit_exceeded
  • 提高或移除已達到的上限後,待更新傳播完成,流量即可恢復。否則,上限會在下一個月度週期重設。

上限並非即時生效。在上限狀態傳播期間,API 平台仍可能處理少量額外用量,因此記錄的支出可能會略微超過設定的金額。

支出警示

使用支出警示,在支出達到強制上限前收到通知。請在適當的門檻新增警示,預留時間調整用量、提高上限,或調查非預期流量。

恢復 API 流量

如果請求因帳務相關上限或點數餘額而失敗:

  1. 檢查 error.code,確認請求是否觸及組織支出上限、專案支出上限或 OpenAI 指定的使用量上限,或是組織已用盡預付點數。
  2. 若錯誤碼為 organization_spend_limit_exceededproject_spend_limit_exceeded,請比較目前用量與支出上限。若需要在每月重設前恢復流量,請提高或移除已達到的上限。
  3. 若錯誤碼為 organization_usage_limit_exceeded,請申請提高核准的使用量上限
  4. 若錯誤碼為 credit_balance_exhausted,請加購點數
  5. 如果錯誤指出請求或 Token 達到速率限制,請依照速率限制指南處理。