CLIProxyAPI の管理
CLIProxyAPI を All API Hub の管理サイトとして利用できます。接続を一度設定すれば、上流プロバイダーの一覧表示、作成、編集、削除や、アカウントのキーと API 認証情報のインポートを行えます。
接続設定
- 設定 → 管理サイト を開き、CLIProxyAPI を選択します。
http://localhost:8317などのデプロイ先 URL を入力します。従来のhttp://localhost:8317/v0/management形式も利用できます。リバースプロキシのパスがある場合は、そのプレフィックスを残してください。- CLIProxyAPI の 管理キー を入力します。管理リクエストの認証に使うもので、クライアントがモデルを呼び出す API キーとは異なります。
- 保存して接続を確認し、チャネル管理 を開きます。
以前の独立した CLIProxyAPI 連携を設定済みの場合、保存された URL と管理キーは自動的に管理サイト設定へ移行します。再入力は不要です。新しい設定がすでにある場合は上書きせず、選択中の別の管理サイトも自動では切り替えません。
CLIProxyAPI 側で管理 API を有効にしてください。リモートのデプロイでは、リモート管理を許可し、ブラウザーから接続できる必要があります。HTTP、localhost、LAN 上のデプロイに対応しています。サーバー側の設定は 公式管理 API ドキュメント を参照してください。
プロバイダーの管理
チャネル管理 で CLIProxyAPI を選択すると、検索、詳細表示、新規作成、編集、有効化・無効化、個別削除・選択した項目の削除を行えます。
対応する API キープロバイダーの種類は次のとおりです。
- OpenAI Compatibility
- Codex
- Claude
- Gemini
- Vertex AI
- xAI
- Gemini Interactions
利用できる種類は CLIProxyAPI のバージョンによって異なります。上流 URL、キー、モデルマッピング、プロキシ、モデル接頭辞、リクエストヘッダーなどを編集でき、編集していないネイティブ設定は保持されます。
モデルマッピング は 1 行に 1 モデルを入力し、別名が必要な場合は モデル名 = エイリアス を使います。リクエストヘッダー は 1 行に 名前: 値 を入力します。API キー型のプロバイダーでは除外モデルも設定できます。
OpenAI Compatibility プロバイダーは複数の API キーに対応しています。キーごとに追加、表示、置換、削除ができ、プロキシと重みも個別に設定できます。保存済みキーは初期状態では非表示で、入力欄を空欄にすると元のキーを保持します。表示するだけでは設定は変更されません。重みが空欄の場合は 1、0 以下の場合は重み付きルーティングの対象外です。保存時には他のキーと未編集のネイティブ設定を保持します。
アカウントキーと API 認証情報のインポート
- 設定 → 管理サイト で CLIProxyAPI を選択し、接続を設定します。
- キー管理 または API 認証情報ライブラリ を開き、項目の管理サイトへのインポートボタンを選択します。
- 共通のインポートダイアログでプロバイダーの種類、上流 URL、キー、モデルを確認して送信します。
- 一括インポートする場合は、キー管理で複数の項目を選択し、管理サイトへの一括インポートを開きます。実行前にプレビューを確認してください。
「エクスポート」メニューにあった独立した CLIProxyAPI の項目は、この管理サイトの操作に統合されました。インポート後もチャネル管理でプロバイダーを編集できます。
よくある質問
- 以前の設定はどこにありますか？ 管理サイト設定で CLIProxyAPI を選択してください。旧 URL とキーは自動移行されます。
- 401 または 403 が返されます。 管理キーとサーバーのリモートアクセス設定を確認してください。クライアント用 API キーでは管理 API を認証できません。
- 特定の種類で 404 が返されます。 デプロイ先 URL、管理 API の有効化、バックエンドのバージョンを確認してください。
- 保存後に再読み込みや結果不確定と表示されます。 再試行する前に一覧を更新し、サーバー上の状態を確認してください。他のクライアントが設定を変更すると、古い編集内容の送信が拒否される場合があります。
- 別のサイトに移行できますか？ チャネル一覧で「チャネルの移行」を有効にしてください。OpenAI Compatibility、Claude、Gemini、xAI、Codex の API Key プロバイダーの対応する経路を利用できます。対応状況はプレビューで確認してください。OpenAI Compatibility の複数 Key はまとめて移行し、移行先で保持できない場合は Key ごとに分割します。モデルの別名や Key ごとのプロキシ、重みは直接コピーされません。詳しくはチャネル移行をご覧ください。
- OAuth アカウントやサーバー全体の設定も管理できますか？ 現在の対象は API Key プロバイダーです。OAuth ログイン、認証ファイル、全体設定には CLIProxyAPI の管理画面を使用してください。OAuth、Vertex の構造化認証情報、Interactions プロバイダーのサイト間移行、およびモデル自動同期は未対応です。