ドキュメント

Open WebUI

Open WebUIでは、OpenAI互換エンドポイントをどれでも接続先として扱います。管理者設定から追加するか、コンテナの起動時に2つの環境変数を設定します。どちらの方法でも同じ接続先になります。

Admin Settingsの1つのOpenAI接続、またはコンテナ起動時のOPENAI_API_BASE_URLとOPENAI_API_KEY — どちらも同じ/v1に接続します。

接続、または docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Model IDs (Filter)を入力してください。設定しないと、画像、動画、音楽のモデルも含むカタログ全体がピッカーに表示されますが、チャットウィンドウからは呼び出せず、ユーザーが最初に選んだモデルがそのいずれかになる可能性があります。エンドポイントに/modelsルートがない場合も、このフィルターを使用します。Kunavoにはそのルートがあるため、どちらの方法でも接続確認に成功します。

URLには/v1が含まれます。Open WebUIがDockerで動作していて、同じホスト上のサービスを接続先に指定する場合は、localhostをhost.docker.internalに置き換えてください。この置き換えはホステッドエンドポイントには当てはまりませんが、接続直後によく発生する問題です。

まだキーをお持ちですか？Kunavoアカウントを作成し、キーを作成します（sk-kn-で始まります）。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Open WebUI設定が表示されます。

手順

/app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
Open WebUIでSettings → Admin → Connectionsに進み、Manage OpenAI API Connectionsを開きます。
➕ Add Connectionをクリックして、URLとAPIキーを入力します。
Model IDs (Filter)に使用するIDを追加し、保存して接続確認を行います。
新しいチャットを開始します。モデルピッカーに、接続名を先頭に付けたモデルが表示されます。

Open WebUIのOpenAI互換プロバイダーガイドで2026年9月6日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがOpen WebUIで機能します。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

モデル ID	Kunavo 入力 / 出力	Open WebUIでの位置付け
`claude-sonnet-5`	$1.40 / $7.00	汎用チャットのデフォルト
`claude-opus-5`	$3.50 / $17.50	長時間の分析スレッド
`claude-haiku-4-5`	$0.70 / $3.50	高速で低コスト、ほとんどのターンに適しています
`gpt-5-6-terra`	$0.70 / $4.20	チャットウィンドウに貼り付ける長い文書

請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト（エディターやチャットクライアントが送る内容の大半）では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

よくある質問

Open WebUIをOpenAI互換APIに接続するにはどうすればよいですか？

Settings → Admin → Connectionsを開き、「Manage OpenAI API Connections」に進んでAdd Connectionをクリックし、エンドポイントURL（/v1ルート）とAPIキーを入力します。同じ接続は、コンテナ起動時にOPENAI_API_BASE_URLとOPENAI_API_KEYの環境変数を設定して作成することもできます。どちらの方法でも同じ接続が作成されます。

Open WebUIのModel IDs (Filter)は何のためにありますか？

その接続からモデルピッカーに表示するモデルIDを制限します。また、/modelsルートを実装していないエンドポイントの代替手段にもなります。その場合はIDを手動で追加します。接続確認は失敗しますが、チャットは引き続き動作します。マルチモーダルカタログが大規模なゲートウェイでは、チャットウィンドウから実際に呼び出せるモデルだけがチャットピッカーに表示されるよう、いずれにしても設定することをおすすめします。

Open WebUIのベースURLに/v1を含めますか？

はい。Open WebUIは指定されたURLにルートのみを追加するため、接続URLにはhttps://api.example.com/v1のように/v1ルートを指定します。ドキュメントにあるエンドポイントの例にも、この接尾辞が付いています。これを付けない場合、接続は保存されますが、すべてのリクエストが404になります。

Open WebUIでClaudeモデルとGPTモデルを使えますか？

はい。OpenAI互換エンドポイント経由で提供されていれば使用できます。Open WebUIはモデルIDを接続URLにそのまま渡すため、どのベンダーのIDもOpen WebUIではなくエンドポイント側で解決されます。そのため、1つの接続と1つのキーでClaudeとGPTのIDを同じモデルピッカーに表示できます。