セルフホスト型サイト管理

拡張機能に登録済みのアカウントを自分のセルフホスト型サイトへ接続すれば、URL やキーをもう一度コピーする手間を省けます。接続後は自分の API からまとめて利用でき、設定の変更やモデル一覧の更新、別サイトへのチャネル移行も拡張機能内で進められます。

サポートされているシステムタイプ

All API Hub は、以下のオープンソース/セルフホスト型 AI 分散システムに深く適応しています。

機能の概要

• 🔑 複数のアカウントを自分の API から利用: セルフホスト型サイトへの接続を設定したら、「キー管理」で使いたいキーを選び、チャネルとしてインポートします。1 件ずつでもまとめてでも取り込めます。URL とキーは自動で入力されるので、コピーし直す必要がありません。
• 📋 チャネルの変更は拡張機能から: チャネルの追加や設定変更は、拡張機能のチャネル一覧から行えます。使わなくなったチャネルは、選んでまとめて削除できます。複数のサイトを設定している場合も、ここで切り替えられます。
• 🔄 モデル一覧の更新を拡張機能におまかせ: 必要なときに、1 件ずつでも複数のチャネルをまとめてでもモデル一覧を同期できます。定期同期をオンにすると、設定した間隔で拡張機能が更新します。同期後は結果を確認できます。
• 📦 サイトを変えても、今のチャネルを引き継ぐ: チャネルと移行先を選び、チャネル移行（テスト版）でコピーできます。引き継げる設定や調整が必要な項目をプレビューで確認してから始められるので、一つずつ作り直す手間を減らせます。

使える機能はサイトによって異なります。それぞれの画面に表示される操作や案内を確認してください。

設定ガイド

管理機能を使用する前に、拡張機能で対応するバックエンドの接続設定を完了する必要があります。

1. 設定ページにアクセスする

拡張機能の設定ページを開き、左メニューの 「基本設定」 に移動して、 「セルフホスト型サイト管理」 を見つけます。

2. 接続情報を入力する

3. 接続を検証する

「設定を検証」 をクリックします。検証に成功すると、対応するシステムの管理エントランスが自動的にロック解除されます。

チャネル管理操作ガイド

1. リスト操作

設定ページ上部の 「セルフホスト型サイト管理」 を選択します（または基本設定の 「チャネルを管理」 ボタンをクリックします）。

• 検索とフィルター: 名前、タイプ、ステータスによるリアルタイム検索をサポートします。
• システムの素早い切り替え: 複数のセルフホスト型システムを設定している場合、上部のスイッチャーを使用して素早く切り替えることができます。
• カスタム列: 「優先度」や「ウェイト」をサポートしていないシステム（Octopus など）の場合、対応する列は自動的に非表示になります。

2. チャネルの作成または編集

1. チャネルを追加をクリックするか、既存のチャネルの編集画面を開きます。
2. システムに応じて接続先、モデル、グループなどを入力し、必要に応じて詳細設定を開きます。
   • New API：モデル検出と自動同期、モデルマッピング、プロキシなど。
   • DoneHub：モデルマッピング、カスタムヘッダー、Responses の互換動作など。
   • ほかのシステムではフォームの案内に従ってください。使用できる項目はチャネルによって異なります。
3. キー欄でキーを入力・変更します。New API、Octopus、AxonHub、CLIProxyAPI の対応チャネルでは複数キーを個別に管理でき、変更しないキーは保持されます。New API ではランダムまたはラウンドロビンも選択できます。
4. 内容を確認して保存します。既存キーの読み取りで認証を求められた場合は、案内に従って完了してください。

3. 安全検証（2FA / OTP）

機密操作（チャネルの実際のキーの表示など）を実行する際、システムで二次検証が有効になっている場合、拡張機能は検証ウィンドウを表示します。

• 詳細は、New API 安全検証 を参照してください。

4. チャネル移行（テスト版）

現在のセルフホスト型サイトのチャネルを、設定済みの別のサイトへコピーできます。チャネルを一つずつ作り直す必要はありません。事前に移行元と移行先の接続を設定してください。

1. 移行元のチャネル一覧で 「チャネルの移行」 を有効にし、チャネルを選択するか、現在の絞り込み結果を使用します。
2. 移行先を選びます。プレビューで種類、URL、モデル、グループ、状態の変更と、引き継げない設定を確認します。
3. 「移行を開始」 をクリックして確認すると、拡張機能が移行元のキーを取得し、移行先にチャネルを作成します。
4. 各チャネルの結果を確認します。「状態不明」 の場合は、一覧を更新して移行先を確認してから再試行を判断し、重複作成を避けてください。

移行では新しいチャネルのみを作成します。移行元の変更、重複チェック、既存チャネルの上書き、自動ロールバックは行いません。

複数 Key のチャネル：プレビューで移行元と移行先の Key 数を比較できます。New API、Octopus、AxonHub、および対応する CLIProxyAPI の API Key プロバイダーから全 Key を移行できます。移行先で複数 Key と有効状態をまとめて保持できる場合は、1 つのチャネルを作成します。それ以外は Key ごとに分割し、名前に [Key 1]、[Key 2] などを付け、結果を個別に表示します。分割によって負荷分散が変わる場合があります。

Key の有効状態は保持されますが、ローテーション設定、無効化の理由、実行履歴、Key ごとのプロキシや重みなどの固有設定は保持されない場合があります。プレビューの案内を確認してください。全 Key を取得できない移行元は移行できません。実行中に Key 数や有効状態が変わった場合は、プレビューを更新して未完了の項目を確認してください。作成済みの項目は自動で再試行されません。

移行できるチャネルの種類や引き継げる設定はシステムによって異なります。移行プレビューの状態と案内を確認してください。グループ、モデルのマッピング、優先度などは変更されたり引き継がれなかったりするため、移行後に移行先でチャネルの設定と有効・無効の状態を確認してください。

移行元のキーを取得するために認証が必要と表示された場合は、認証を完了してから再試行してください。必要な認証方式に対応していない場合は、移行元の管理画面でキーを取得し、移行先にチャネルを手動で追加してください。

よくある質問

関連ドキュメント

• セルフホスト型サイトモデル同期: チャネルモデルを一括で自動同期します。
• クイックエクスポートと統合: チャネルをダウンストリームアプリケーションにプッシュする方法を確認します。
• サポートされているサイトリスト: その他の互換性のあるシステムを表示します。