使用支出警示追蹤每月 API 費用。若要在追蹤到的支出達到設定金額後停止流量,請為組織或個別專案啟用強制支出上限。
強制支出上限可能會中斷正式環境的流量。當追蹤到的支出達到
適用的強制上限時,受影響的 API 請求會傳回 429 錯誤,錯誤碼為
organization_spend_limit_exceeded 或 project_spend_limit_exceeded。
上限並非即時生效,因此記錄的支出可能會略微超過
設定的金額。
選擇支出控管方式
支出警示與強制支出上限的作用不同:
| 控管方式 | 達到設定金額時的行為 | 適用目的 |
|---|---|---|
| 支出警示 | 傳送通知;API 流量不受影響 | 追蹤支出,同時維持流量不中斷 |
| 強制支出上限 | 受影響的 API 請求會傳回 429 錯誤 | 強制執行組織或專案的每月支出上限 |
支出警示不會強制限制支出。新增強制支出上限後,警示仍會保持啟用,因此您可以利用警示,在強制上限中斷流量前收到通知。
OpenAI 也會根據組織的使用量級別,為其核准每月的使用量上限。這項由 OpenAI 核准的使用量上限,與您自行設定的支出上限各自獨立。
設定支出上限
您需要具備管理相關組織或專案設定的權限。詳情請參閱 API 平台權限。
瞭解強制上限的運作方式
組織和專案的強制上限可以同時適用於同一個請求:
- 組織的強制上限適用於組織內所有專案的 API 流量。
- 專案的強制上限僅適用於費用計入該專案的 API 流量。
- 達到組織的強制上限時,會傳回
429錯誤,錯誤碼為organization_spend_limit_exceeded。 - 達到專案的強制上限時,會傳回
429錯誤,錯誤碼為project_spend_limit_exceeded。 - 提高或移除已達到的上限後,待更新傳播完成,流量即可恢復。否則,上限會在下一個月度週期重設。
上限並非即時生效。在上限狀態傳播期間,API 平台仍可能處理少量額外用量,因此記錄的支出可能會略微超過設定的金額。
支出警示
使用支出警示,在支出達到強制上限前收到通知。請在適當的門檻新增警示,預留時間調整用量、提高上限,或調查非預期流量。
恢復 API 流量
如果請求因帳務相關上限或點數餘額而失敗:
- 檢查
error.code,確認請求是否觸及組織支出上限、專案支出上限或 OpenAI 指定的使用量上限,或是組織已用盡預付點數。 - 若錯誤碼為
organization_spend_limit_exceeded或project_spend_limit_exceeded,請比較目前用量與支出上限。若需要在每月重設前恢復流量,請提高或移除已達到的上限。 - 若錯誤碼為
organization_usage_limit_exceeded,請申請提高核准的使用量上限。 - 若錯誤碼為
credit_balance_exhausted,請加購點數。 - 如果錯誤指出請求或 Token 達到速率限制,請依照速率限制指南處理。