Open WebUI
Open WebUI をインストールし、OpenAI 互換の接続として RunAPI を追加して、モデルを選択し、チャットを確認します。
OpenAI互換接続を通じてOpen WebUIをRunAPIに接続します。Open WebUI管理者アクセスと、認証ガイドから取得した標準のRunAPI APIキーが必要です。
Open WebUI のインストール
ご利用のプラットフォーム向けの公式Open WebUIクイックスタートに従ってください。ローカルのDockerインストールの場合、以下のコマンドで公式イメージを起動できます：
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
アプリケーションを開き、管理者アカウントを作成してサインインしてから、接続を追加してください。
RunAPI 接続を追加
- 管理設定 → 接続 → OpenAI を開き、接続を追加を選択します。
- URL を
https://runapi.ai/v1に設定し、RunAPI の API キーを入力します。 - 最初の接続試行時は モデル ID（フィルター）を空のままにして、Open WebUI が利用可能なモデルを自動検出できるようにします。
- 接続を保存し、検証が完了するまで待ちます。
Open WebUIはバックエンドから接続チェックを送信し、検出にGET
/v1/modelsを使用します。RunAPIのURLはパブリックHTTPSであるため、Dockerインストールではこの接続にhost.docker.internalは不要です。
モデルを選択する
新しいチャットを開き、チャットモデルセレクターからRunAPIモデルを選択してください。現在のモデル識別子と機能の確認にはモデルカタログを使用してください。
モデルディスカバリーでセレクターが表示されない場合は、接続を編集して Model IDs (Filter) に正確な識別子を追加してください。モデルディスカバリーエラーと Chat Completions エラーは別々のシグナルです。接続を削除する前に手動で追加したモデルをテストしてください。
接続を確認する
Reply with the word connected.などの短いプロンプトを送信してください。通常のストリームまたは完全なレスポンスが返れば、Open WebUIが選択したRunAPIモデルを使用できることが確認されます。
トラブルシューティング
- 検証が
401または403を返す: 接続の API キーを、認証ガイドから取得した有効な標準キーに置き換えてください。 - RunAPI のモデルが表示されない: URL が
/v1で終わっていることを確認し、現在の識別子を 1 つ Model IDs (Filter) に追加してチャットを再試行してください。 - モデルは表示されるがチャットに失敗する: モデルカタログで識別子が OpenAI 互換の Chat Completions をサポートしていることを確認し、Open WebUI バックエンドのログでリクエストのステータスを確認してください。
- ローカル URL はブラウザで動作するが Open WebUI では動作しない: Open WebUI の接続はバックエンドから発信されます。これはパブリックの
https://runapi.ai/v1URL には影響しませんが、他のローカル接続には関係します。
共通のプロトコル動作については、LLM API クイックスタートを参照してください。リクエストおよびレスポンスのフィールドについては、Chat Completions API リファレンスを参照してください。