AI API キーのセキュリティとコスト管理
用途別のキー、クォータ、有効期限、モデル制限、IP 許可リスト、ルーティングポリシー、ローテーション、監査可能なコストの帰属によって、AI ワークロードを保護します。

AI API キーは、組織全体を無期限に表すものではなく、1 つのワークロードの境界を示すものであるべきです。キーを分けておけば、1 つの認証情報を無関係なアプリケーション間で共有することなく、アクセス、クォータ、ルーティング、ローテーション、利用記録を管理しやすくなります。
Modelflare の API キーでは、有効期限、上限付きまたは無制限のクォータ、モデル制限、IP 許可リスト、ルーティングポリシーを組み合わせて設定できます。これらの管理策は、インシデントが起きてから追加するのではなく、まとめて設計したときに最も効果を発揮します。
ワークロードごとに 1 つのキーから始める
アクセスやコストの計上を独立させる必要がある境界ごとに、別々のキーを作成します。たとえば次のような単位です。
- 本番環境の API とバックグラウンドワーカー
- 開発環境と CI
- コーディングエージェントやローカルツール
- 顧客向けアプリケーション
- 一時的な外部委託先や移行作業
- 高コストのバッチワークロード
prod-support-agent や dev-evaluation のように、環境と用途がわかる名前を付けてください。わかりやすい名前を付けておくと、シークレットを明かさなくても、リクエスト記録やローテーションの判断を理解しやすくなります。
シークレットをクライアントから見えるコードに含めない
キー全体は、サーバー側のシークレットマネージャーか、保護された環境変数に保存します。次の場所には含めないでください。
- ユーザーが中身を確認できるブラウザーの JavaScript やモバイルアプリのパッケージ
- ソース管理、コンテナーイメージ、スクリーンショット、チケット
- 分析イベント、エラートラッカー、シェルの履歴、アプリケーションのログ
- URL、クエリ文字列、実際の値が入ったままコピーしたコマンド例
ブラウザーで動作するアプリケーションでは、ユーザーを認証し、Modelflare のキーを保持するバックエンドを経由してリクエストを送信します。キーが漏えいした可能性がある場合は、代わりのキーを作成してワークロードを移行し、新しいキーでトラフィックを確認してから、古いキーを失効させてください。
クォータと有効期限を独立した境界として使う
上限付きのキークォータは、そのキーの使用量に厳格な上限を設けます。有効期限は、認証情報が有効な期間を制限します。この 2 つは、それぞれ異なるリスクに対処します。
| 管理策 | 主な目的 |
|---|---|
| 上限付きクォータ | そのキーに帰属する使用量を制限する |
| 無制限のクォータ | キー単位の上限を設けない。アカウントのクレジットやその他のポリシーは引き続き適用される |
| 有効期限 | 定めた期間が過ぎたらアクセスを終了する |
| 無効化または失効 | 新たなアクセスを直ちに停止する |
開発用、外部委託先用、評価用のキーには、通常、上限付きのクォータと有効期限の両方を設定すべきです。本番用のキーでは、より大きなクォータや無制限のクォータが必要になることもありますが、その場合でもワークロード別のコスト計上とローテーション計画が役立ちます。
クォータは、同時実行数の制限やクライアント側の再試行制御の代わりにはなりません。リクエストが急増すると残量がすぐに消費されることがあり、失敗が繰り返されると追加のリクエストが発生することもあります。
ワークロードの範囲が限られている場合はモデルを制限する
モデル制限を設定すると、キーが想定外のモデルをリクエストできなくなります。互換性のないモデルや想定以上に高価なモデルを誤って使うリスクが減り、クライアントがアクセスすべきでないものを要求したときには、明確な 403 の境界が得られます。
許可するモデルの範囲は、エンドポイントに合わせておきます。モデルを一覧表示できるキーであっても、そのモデルのリクエスト形式に対応したクライアントとプロトコルが必要です。モデル ID を長期的に使うポリシー文書にコピーするのではなく、モデルと料金で最新の仕様を確認してください。
ネットワーク経路が安定している場合にのみ IP ルールを追加する
IP 許可リストは、Modelflare が観測したクライアントの IP を、キーに設定された個別のアドレスまたは CIDR 範囲と照合します。送信元が決まっているサーバーには便利ですが、次のような場合にトラフィックが遮断されることがあります。
- クラウドのワークロードで、送信用 NAT のアドレスが変わった
- リクエストが新しいプロキシやゲートウェイを経由するようになった
- IPv4 と IPv6 で経路が異なる
- 開発者が別のネットワークに切り替えた
- 設定した CIDR が意図より広い、または狭い
制限を有効にする前に実際の送信経路を確認し、緊急時のローテーション手順を用意しておいてください。また、IP 許可リストをシークレット保護の代わりとみなさないでください。
通常ルーティングとスマートルーティングを意図して選ぶ
| キーの種類 | ルーティングの動作 | 適した用途 |
|---|---|---|
| 通常の API キー | 明示的に指定した 1 つのプライマリグループと、任意で設定する順序付きのフォールバックグループ | ルートの順序とグループのポリシーを把握しておく必要があるワークロード |
| スマート API キー(Smart API Key) | バランス重視、安定性重視、低価格重視のいずれかの方式で、アカウントで利用可能なグループを評価する | より広い範囲で自動的にルートを選択したいワークロード |
どちらの種類のキーでも、リクエストしたモデルとプロトコルはそのまま送信されます。ルーティングポリシーは条件を満たすグループを選択するものであり、すべてのグループがすべてのモデルや機能に対応していることを保証するものではありません。通常のフォールバックリストは、順番どおりにテストしてください。スマート API キーは、本番環境で使う前に、実際のレイテンシ、価格、互換性の要件に照らして評価してください。
詳しい動作については、信頼性の高い AI API ルーティングをお読みください。
避けられる停止を起こさずにローテーションする
新旧のキーを並行して使える期間を設けてローテーションします。
- 同じ制限を設定した新しいキーを作成します。
- アプリケーションのシークレット管理システムに保存します。
- 古いキーを削除せずに、新しい認証情報をデプロイします。
- モデルへのアクセスと、実際のリクエスト 1 件を確認します。
- 新しいキーで利用記録が作成されていることを確認します。
- すべてのデプロイ環境と自動化ジョブから古いキーを削除します。
- 古いキーを無効化または削除します。
- 廃止した認証情報を使った予期しないリクエストがないか監視します。
漏えいが進行中の場合は、まずキーを失効させ、管理された範囲での中断を受け入れてください。並行期間を設ける手順は計画的なローテーションのためのものであり、漏えいした状態を続けるためのものではありません。
キーのポリシーをコストの確認に結び付ける
キー単位で分離しておくと、コストの確認を具体的な対策につなげられます。利用ログをキーで絞り込み、モデル、グループ、入力と出力の使用量、ステータス、再試行、コストを比較します。上限付きのクォータでそれ以上の使用を止めることはできますが、何がクォータを消費したのかを説明するのはリクエスト記録です。
繰り返し使える確認プロセスについては、AI API コスト追跡を参照してください。
API キーのチェックリスト
- アプリケーション、環境、または責任を持つワークロードごとに 1 つのキーを使う
- ブラウザーのコード、リポジトリ、ログ、URL、スクリーンショットにシークレットを含めない
- 一時的な利用や試験的な利用には、上限付きのクォータと有効期限を設定する
- 範囲が限られたワークロードには、モデル制限を設定する
- IP ルールは、検証済みで安定した送信経路にのみ使う
- 通常のフォールバック順序を明示するか、スマート方式を意図して選択する
- 古いキーを削除する前に、ローテーションをテストする
- ポリシーを変更するたびに、キーごとの使用量とコストを確認する
よくある質問
無制限のキーにすると、すべての支出上限がなくなりますか?
いいえ。なくなるのはキー単位のクォータの上限だけです。アカウントのクレジット、モデルの価格、グループのポリシー、リクエストの上限、その他のサービス上の管理は引き続き適用されます。
複数のキーを使えば、レート制限を回避できますか?
必ずしもそうではありません。上限はアカウント、モデルグループ、ルートの単位で適用されることがあります。キーはアクセスの管理とコストの帰属のために作成するものであり、検証されていないレート制限の回避策として使うものではありません。
キーが漏えいした場合、IP 許可リストだけで十分ですか?
いいえ。ネットワークのルールはキーを使用できる場所を限定しますが、ネットワーク経路は変わることがあり、設定が誤っている可能性もあります。漏えいした認証情報はローテーションし、保存時もデプロイ時もシークレットを保護してください。