Groupとチャネル
Groupには、接続先のサービス、認証情報プール、公開モデル、実行ポリシーなど、アップストリーム接続に必要な設定がまとまっています。
Groupとは§
1つのGroupは1つのアップストリームサービスに対応し、認証情報プールを持ちます。リクエストごとに利用可能な認証情報を選び、レート制限中または無効な認証情報は自動的に避けて別のものを使います。
GroupとAccessKeyの役割は基本概念を参照してください。要約すると、Groupはアップストリームに接続し、AccessKeyはアプリケーションを認可します。
20の組み込みチャネル§
Group作成時にこれらの中から一つを選択します。よく使うチャネルはボタンとして直接表示され、その他のチャネルは「その他のチャネル」に収められます。異なるカテゴリーの認証情報の形態は異なります：
| カテゴリ | チャネル | 認証情報の種類 |
|---|---|---|
| 公式 API | OpenAI · Anthropic · Gemini · xAI | APIキー |
| クラウドプラットフォーム | Azure OpenAI · AWS Bedrock · Google Vertex AI | プラットフォーム認証情報（AK/SK またはサービスアカウント） |
| モデルサービス | DeepSeek · Moonshot AI · SiliconFlow · Zhipu AI · Alibaba Cloud · Volcengine · OpenRouter · Groq | APIキー |
| サブスクリプションアカウント | Codex · Claude · Antigravity · Grok | OAuth 認可 |
| カスタム | OpenAI Compatible | APIキー + カスタムエンドポイント |
各チャネルは対応するプロトコルと機能を宣言します。ゲートウェイは対応する機能間を変換しますが、万能な変換器ではありません。境界はプロトコルと変換境界を参照してください。
Groupを作成§
Group → チャネル認証情報のインポート → 新規Group作成を開きます。入力する中心項目は、チャネル、認証情報、モデルの3つだけです。
アップストリームサービスごとに1つのGroupを作成します。同じプロバイダーの複数のキーは分割せず、そのGroupにまとめてください。
チャネルパラメータ§
チャネルを選択した後、フォームにそのチャネル固有のパラメータが表示されます。一般的なものは：
- エンドポイント URL — 公式チャネルにはデフォルト値があります。中継サービスまたは自前のサービスを使う場合だけ変更します。
- リージョン — AWS Bedrock や Google Vertex AI などのクラウドプラットフォームではリージョンを指定します。
- デプロイメント名 — Azure OpenAI のモデルデプロイ識別子です。
これらの値が誤っていると、通常はすべてのリクエストが失敗します。監視とトラブルシュートのルートチェックで、候補になったGroupと現在利用可能な認証情報数を確認できます。
認証情報プールの管理§
認証情報プールはGroupの中核です。複数のキー間でゲートウェイがローテーションするため、1つのキーに問題が起きてもプール全体には影響しません。
上部で状態別に統計。使用可能なものはローテーションに参加、クールダウン中は一時スキップ、ブラックリストは自動で除外。
認証情報は以下の操作が可能です：
- バッチインポート — Group一覧から専用の「チャネル認証情報をインポート」ページを開き、1行に1つずつキーを貼り付けます。
- 有効化／無効化 — 無効にするとローテーションから外れますが、プールには残ります。
- 個別ウェイト — 特定のキーに割り当てるトラフィックを増減します。
- 接続テスト —— この認証情報で最小限の実リクエストをアップストリームへ送り、まだ使えるかをその場で確認します
- 実際の値を確認 — 認証情報は暗号化して保存されます。必要な場合だけ明示的に値を表示できます。
- 個別にプロキシを設定 — 特定のキーだけ別の送信経路を使う場合に設定します。代理とリクエストヘッダーを参照してください。
重複するキーは自動的に検出してスキップされるため、ブロック全体をそのまま貼り付けられます。
テストは 実際のアップストリームリクエストを送信します、少額の費用が発生します。スケジューリングやブラックリストの状態を変更しません ため、キーがまだ有効かどうかの確認に安心して使えます。
結果は 3 種類あります：テスト合格、テスト不合格（キーが無効か、アップストリームのレート制限か、モデルが利用不可かを示します）、そして 判定不能 —— 最後のケースは通常タイムアウトか、そのチャネルがプローブに対応していないことを示し、キーに問題があるとは限りません。
テストした認証情報が現在ブラックリスト入りしている場合、テストに通るとその場で復帰するかを尋ねられるため、ヘルスページに戻る必要はありません。
公開するモデル§
Groupでは、外部に公開するモデルを指定します。アップストリームから自動検出するか、手動で追加できます。
この一覧にあるモデルだけを、このGroup経由でリクエストできます。
モデルエイリアスは同じ表で設定します。価格とコスト見積もりはモデル管理を参照してください。
運用ポリシー§
「設定」タブには、このGroupの実行パラメーター（ウェイト、タイムアウト、リトライ回数、クールダウンしきい値、セッションアフィニティ、アウトバウンドプロキシ）があります。
これらのパラメーターはシステムレベルにもあります。Groupで値を設定するとシステム値を上書きし、未設定なら継承します。
各パラメーターの役割と変更すべき場面は、実行時設定を参照してください。
カスタムチャネル§
組み込み一覧にないサービスでも、OpenAI 互換 API ならOpenAI Compatibleを選び、エンドポイント URL とキーを入力します。中継サービスや自前の推論サービスにはこの方式を使います。
Groupを分けるタイミング§
Groupを分けるべきケース：
- 異なるアップストリームサービスと接続する場合——これは必須で、1つのGroupは1つのチャネルしか選べません。
- 同じサービスプロバイダーでも、2つのキーセットで異なる戦略を使う場合（例：1つは主用、1つはバックアップ）
- 同じサービスプロバイダーでも、アプリごとに公開するモデル範囲が異なる場合
Groupを分けなくてよい場合：同じプロバイダーの複数のキーです。1つのプールにまとめることで、ゲートウェイがローテーションと障害回避を行えます。分割すると相互のフォールバックが失われます。
Codex、Claude、Antigravity、Grok などのアカウントは、APIキーではなく OAuth 認可を使います。コールバックポートやリモートデプロイなどの追加設定はサブスクリプションアカウントを参照してください。