WebUI API セットアップを開く

Open WebUI は、プロバイダーごとに個別のプラグインを必要とするのではなく、プロトコルごとにモデル サービスを管理します。 TokenHub を OpenAI API Connection として追加します。次に、Open WebUI は、/models と /chat/completions を API のベース URL に追加します。

[管理者接続] に TokenHub を追加します。

これは、Open WebUI の公式 Step 1: Add Your Provider Connection シーケンスに従います。

1. 管理者アカウントで Open WebUI にサインインします。
2. Settings → Admin → Connections に移動します。
3. Manage OpenAI API Connections を見つけて、Add Connection (プラス ボタン) をクリックします。
4. URLにhttps://us-api.tokenhub.com/v1と入力します。
5. API Key に TokenHub API キーを入力します。
6. 接続検証でモデルが返されない場合は、Model IDs (Filter) の下に正確な TokenHub モデル ID を入力し、プラス ボタンをクリックして許可リストに追加します。
7. 「Save」をクリックします。

/chat/completions を URL に入れないでください。 Open WebUI はリクエスト パス自体を追加するため、完全なリクエスト URL は重複したパスを作成します。

接続とモデル ID の確認 (フィルター) を理解する

保存する前に、Open WebUI は標準のベアラー トークン リクエストをプロバイダーの /models エンドポイントに送信します。そのドキュメントには、一部の互換性のあるサービスは、チャット完了が機能する場合でも、この検出リクエストに対して 400、401、または 403 を返すことが記載されています。次の順序でテストします。

1. モデル ID を Model IDs (Filter) の下に手動で追加して保存します。
2. 新しいチャットを開始し、モデルがセレクターに表示されることを確認します。
3. それを選択してメッセージを送信し、実際のチャット完了リクエストをテストします。

各モデル ID は 1 回だけ追加します。 Open WebUI は周囲の空白をトリミングします。接続の横にあるスイッチは、設定を削除せずにプロバイダーを一時的に無効にします。

リモート API を host.docker.internal に置き換えないでください。

公式 host.docker.internal ヒントは、Open WebUI コンテナーが Docker ホスト上で実行されているモデル サーバーに到達する必要がある場合にのみ適用されます。 TokenHub はリモート HTTPS サービスなので、https://us-api.tokenhub.com/v1 を保持してください。コンテナーのみがタイムアウトする場合は、URL を localhost に変更するのではなく、その DNS 解決、アウトバウンド HTTPS アクセス、およびプロキシ構成を検査します。

Open WebUI が実際に送信するリクエストを確認する

1. チャットを作成し、許可リストに追加した TokenHub モデルを選択します。
2. 最初に短いテキストのみのメッセージを送信します。
3. TokenHub リクエスト ログで、パスが /v1/chat/completions であり、モデル ID が正確で、使用状況が記録されていることを確認します。
4. 基本的なチャットが機能した後でのみ、ツール、画像、ナレッジ機能を個別にテストします。 Open WebUI のコントロールは、選択したモデルまたは互換性のあるエンドポイントがその機能をサポートすることを保証しません。

404 の場合は、まず URL が /v1 で終わることを確認します。モデルが見つからない場合は、Model IDs (Filter) に戻ります。 Docker のみで障害が発生する場合は、コンテナ ネットワークを検査します。

公式リファレンス

• Open WebUI: OpenAI-compatible プロバイダーに接続