支出アラートを使うと、毎月の 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の場合は、クレジットを追加します。- エラーがリクエスト数またはトークン数のレート制限を示している場合は、レート制限ガイドに従ってください。