API Keys
API Key は、アプリケーションが OneGateway を通じてモデルを呼び出す際の認証情報です。API Keys ページで自分のキーを作成・管理できます。一覧にはあなたのキーのみが表示されます。
ページ上部の API URL は、アプリケーションのリクエスト先となるサービスのアドレスです。右側のアイコンをクリックしてコピーします。アプリケーションが使用する API 形式（OpenAI、Anthropic など）に合わせて API URL と API Key を設定すれば、呼び出しを開始できます。完全なリクエスト例はクイックスタートを参照してください。
API Key を作成する
右上の Create API Key をクリックし、name を入力して OK をクリックすると作成されます。名前は用途を区別するためのもので、たとえば「Chatbox key」のように付けます。
この方法で作成した API Key は、クォータの上限なし、有効期限なし、あなたのグループ料金を使用し、利用可能なすべてのモデルを呼び出せます。制限を設けたい場合は Advanced settings を開きます。
| フィールド | 役割 | 空欄の場合 |
|---|---|---|
| Quota | この API Key が消費できる金額の上限 | 上限なし |
| Expiration time | この日時に達するとキーが自動的に無効になります | 有効期限なし |
| Group Pricing | 呼び出しの課金倍率を決定します | あなたのグループ料金を使用 |
| Available models | このキーで呼び出せるモデルを限定します | 利用可能なすべてのモデル |
グループ料金と利用可能なモデルの選択範囲は管理者が設定します。あなたが呼び出せるモデルは利用可能なモデルを参照してください。
og-auto などの仮想モデルを使う場合
利用可能なモデルを制限したキーは、インテリジェントルーティングによる書き換え後の実際のモデルで検証されます。仮想モデル名だけを選択しても意味がありません。使われる可能性のあるすべての対象モデルと候補モデルを利用可能なモデルに追加しないと、リクエストは 403 を返し、候補モデルへの切り替えも発生しません。使われる可能性のあるモデルは管理者に確認してください。
作成後、キーはカード上でマスクされた形式で表示されます。キーの右側にあるコピーアイコンをクリックして完全な値を取得し、アプリケーションに貼り付けて保存してください。
既存の API Keys を管理する
各カードが 1 つの API Key に対応します。
| カードの内容 | 説明 |
|---|---|
| 名前とグループ料金 | キーの名前と、そのキーが使用するグループ料金 |
| クォータ | クォータ未設定の場合は「Unlimited」と表示されます。クォータを設定している場合は、残りクォータ（Remaining Quota）、使用済みクォータ、使用率が表示されます |
| ステータススイッチ | このキーで呼び出しできるかどうかを制御します。オフにした後は、設定が同期されたことを確認し、旧キーによるリクエストが拒否されることを検証してください |
| Available models | 制限していない場合は「All models」と表示されます |
| 有効期限 | 期限日または「Never Expires」が表示されます。期限切れのものにはマークが付きます |
| キー | マスク表示されます。右側のアイコンをクリックすると完全なキーをコピーできます |
カード右上には Edit、View usage、Delete の 3 つのボタンがあります。
キーの漏洩が疑われる場合は、削除せずにまず無効にしてください
まずステータススイッチをオフにしてこのキーの履歴を残し、設定の同期と呼び出しが拒否される結果を確認します。セマンティックキャッシュを有効にしている場合は、キャッシュヒットとアップストリームへの転送の両方の経路も個別に検証する必要があります。アクセス停止の確認手順を参照してください。不要であることを確認してから削除してください。削除は元に戻せず、そのキーを使用しているアプリケーションに影響します。
制限を変更する
カードの編集ボタンをクリックして詳細ページを開き、変更後に右上の Update をクリックします。
| 領域 | 変更できる内容 |
|---|---|
| 基本情報 | 名前とグループ料金は変更できます。部署、メンバー、ステータス、キー、作成日時はシステムが管理しており、変更できません |
| クォータと有効期間 | Unlimited にチェックを入れるか、具体的なクォータを入力して有効期限を設定します。横のショートカットで Never、1 hour、1 day、1 month を選択できます |
| アクセス制限 | available models を調整します。IP restrictions には、アクセスを許可するアドレスを 1 行に 1 つずつ入力します。空欄の場合は制限なしです |
グループ料金または利用可能なモデルを変更した後は、このキーで一度呼び出しを行い、リクエストログで実際に使用されたモデルと費用が想定どおりであることを確認してください。