Skip to Content
はじめに上限とアクセス

上限とアクセス

コンソールの 設定 → 上限とアクセス で、チーム全体の予算とアクセスルールをまとめて管理できます。想定外の使いすぎを防ぎ、API Key が漏えいしたときの不正利用も防げます。

ルール役割設定場所
予算上限上限に達したら呼び出しを停止チーム・メンバー:上限とアクセス、Key:API Keys
IP 許可リスト指定したサーバーからの呼び出しだけを許可チーム:上限とアクセス、Key:Key メニューの「IPホワイトリスト」
利用可能なモデル呼び出せるモデルを制限チーム:上限とアクセス、Key:Key メニューの「利用可能なモデル」
リクエストレートチームの全 Key で共有する 1 分あたりのリクエスト数閲覧のみ。詳しくは レート制限

これらのルールを変更できるのはチームのオーナーと管理者だけです。変更はすべてページ右上の 変更履歴 に記録されます。

予算上限

予算はチーム、メンバー、API Key の 3 階層で、期間は 日次、月次、累計 から選べます。

  • チームの予算:チーム全体の支出上限
  • メンバーのデフォルト予算:メンバーごとに計算。個別に予算を設定したメンバーはそちらが優先されます
  • Key の予算:API Keys ページで Key ごとに設定

3 階層はそれぞれ別に計算され、どれか 1 つでも使い切るとリクエストはブロックされます。同じ期間内では、Key の予算は所属メンバーの予算を、メンバーの予算はチームの予算を超えられません。

予算ごとに上限到達時の動作を選べます:

動作上限に達したとき
通知してブロックメールで通知し、呼び出しを停止
通知のみメールで通知するだけで、ブロックしない

予算を使い切った後にチャージしても、呼び出しは再開されません。上限を引き上げるか、日次 / 月次の期間リセットを待ってください。

IP 許可リスト

指定した IPv4 アドレスまたは CIDR 範囲からの呼び出しだけを許可します(最大 100 件)。リストにないアドレスからのリクエストは拒否されます。

  • チームの IP 許可リスト:チームのすべての API Key に適用
  • Key の IP 許可リスト:チームのリストをもとに、Key ごとにさらに絞り込みます。Key のリストにあるアドレスも、チームのリストに含まれていなければ有効になりません

本番環境の Key を自社サーバーに固定するのに適しています。Key が漏えいしても、ほかの場所からは呼び出せません。

利用可能なモデル

チームでは 3 つの方式から選べ、プロバイダー単位でまとめて選択することもできます:

方式説明
すべてのモデルすべてのモデルを呼び出せます。今後追加される新しいモデルも含みます
次のモデルのみ許可リストにあるモデルだけを呼び出せます。今後追加される新しいモデルも呼び出せません
次のモデルを禁止リストにあるモデルは呼び出せません。ほかのモデルには影響しません

Key ごとに、Key メニューの「利用可能なモデル」でさらに絞り込むこともできます。チームと Key のルールは同時に適用され、両方で許可されたモデルだけを呼び出せます。

適用ルールを確認

1 つの Key にはチームと Key の 2 階層のルールが適用されます。API Keys の Key メニューで 適用ルールを確認 をクリックしてモデルを選ぶと、その呼び出しがブロックされるか、どのルールでブロックされるか、予算がどれだけ残っているかを確認できます。確認でクレジットは消費されません。

ブロック時のレスポンス

予算やアクセスルールでブロックされたリクエストは、リトライしても成功しません。先にルールを調整してください:

ステータスコードエラーコード原因対処方法
402spending_limit_exceededチーム・メンバー・Key の予算上限を超えた上限を引き上げるか、期間リセットを待つ
402insufficient_credits残高不足チャージする
403ip_not_allowed呼び出し元 IP が許可リストにないその IP をチームまたは Key の許可リストに追加
403model_not_allowedチームまたは Key でこのモデルが許可されていない別のモデルを使うか、利用可能なモデルを調整
503spending_limit_check_unavailable予算を一時的に確認できないしばらくしてからリトライ

ブロックされたリクエストは アクティビティ の「ブロック」フィルターに表示されます。エラーコードの一覧は エラーハンドリング をご覧ください。

変更履歴

IP 許可リスト、利用可能なモデル、予算について、誰がいつ何を変更したかは、上限とアクセス 右上の 変更履歴 でさかのぼって確認できます。ログ保存の設定はここには記録されません。リクエストログ をご覧ください。

最終更新日