API キー

API キーは Glacier AI を呼び出すための認証情報です。用途ごとにキーを作成して管理すれば、クォータ、モデル、グループ、送信元の制限を個別に設定できます。

左側ナビゲーションで「API キー」をクリックするか、/keys に直接アクセスします。ページにはキー名、マスクされたキー、有効状態、クォータの使用状況、グループなどが表示され、絞り込み、コピー、編集、有効化／無効化、一括削除が行えます。行メニューからは接続情報のコピー、管理者が設定したチャットプリセットの起動、対応クライアント連携へのキー送信も可能です。

API キーの作成

「API キー」を開き、「API キーを作成」をクリックします。
アプリや環境を区別しやすいキー名を入力します。
必要に応じてクォータ、有効期限、モデル制限、IP 制限、グループを設定します。
保存後、一覧から完全なキーを表示してコピーします。

設定項目

設定	効果
名前	API キーの名前（「本番環境」「テスト用」など用途がわかる名前を推奨）
グループ	このキーが使用するチャネルグループ
Auto グループの順序	グループが `auto` のときのみ表示されます。既定の順序のままにするか、このキー専用にグループを試す順序を指定できます
グループ横断リトライ	有効にすると、現在のグループが使えないときに次のグループへ順に切り替えます。可用性は上がりますが、グループによって価格が異なる場合があります
有効期限	期限を過ぎるとこのキーの使用を拒否します
数量	API キーを一度に複数作成できます（名前にランダムな接尾辞が付きます）
クォータ	このキーが消費できるクォータの上限
無制限クォータ	有効にすると、この API キーのクォータを無制限にします
モデル制限	このキーで呼び出せるモデルを限定します。空欄は制限なしです
IP 許可リスト	IP または CIDR を 1 行ずつ入力します。空欄は制限なしです。固定のグローバル IP を持つサーバー向けです。家庭回線やモバイル回線は IP が変わるため、自分自身を締め出しやすくなります

API キーの表示とコピー

一覧でマスクされたキーをクリックし、画面の案内に従って完全な値を表示・コピーします。完全なキーは機微な認証情報のため、表示に追加のセキュリティ確認が必要になる場合があります。

「接続情報をコピー」を使うと、キーとプラットフォームのアドレスをアプリ取り込み用の情報としてコピーできます。左サイドバーの「チャット」からプリセットのチャットアプリをクリックすると、ブラウザーがインストール済みのチャットアプリを起動し、設定情報を自動的に入力します。詳細はチャットアプリ連携を参照してください。

API キーの編集

一覧で対象のキーを見つけ、右側の「編集」ボタンをクリックすると設定項目を変更できます（API キーの値そのものは変更できません）。

API キーの有効化・無効化・削除

一覧の行操作からキーを有効化、無効化、削除できます。複数行を選択すれば一括削除も可能です。無効化は設定を残したまま呼び出しを止め、削除は元に戻せません。