上限とアクセス
コンソールの 設定 → 上限とアクセス で、チーム全体の予算とアクセスルールをまとめて管理できます。想定外の使いすぎを防ぎ、API Key が漏えいしたときの不正利用も防げます。
これらのルールを変更できるのはチームのオーナーと管理者だけです。変更はすべてページ右上の 変更履歴 に記録されます。
予算上限
予算はチーム、メンバー、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 メニューで 適用ルールを確認 をクリックしてモデルを選ぶと、その呼び出しがブロックされるか、どのルールでブロックされるか、予算がどれだけ残っているかを確認できます。確認でクレジットは消費されません。
ブロック時のレスポンス
予算やアクセスルールでブロックされたリクエストは、リトライしても成功しません。先にルールを調整してください:
ブロックされたリクエストは アクティビティ の「ブロック」フィルターに表示されます。エラーコードの一覧は エラーハンドリング をご覧ください。
変更履歴
IP 許可リスト、利用可能なモデル、予算について、誰がいつ何を変更したかは、上限とアクセス 右上の 変更履歴 でさかのぼって確認できます。ログ保存の設定はここには記録されません。リクエストログ をご覧ください。