Open WebUI OpenAI APIベースURL：Flatkeyセットアップガイド

Open WebUI OpenAI APIベースURL設定は、Open WebUIがチャットトラフィックを1つのアップストリームプロバイダー、ローカルモデルサーバー、またはFlatkeyのようなルーターに送信するかどうかを決定する小さなフィールドです。チームでのデプロイメントの場合、そのフィールドは単なるコピー＆ペーストの詳細として扱われるべきではありません。APIキー、モデルID、モデル検出の動作、チャット補完、ストリーミング、および使用状況ログとともに確認する必要があります。

このガイドは、Open WebUIをOpenAI互換のモデルルーターとしてFlatkeyを使用したい開発者、AI製品チーム、自動化ビルダー、プラットフォームエンジニア、財務担当者、および調達レビュー担当者向けに書かれています。現在のOpen WebUIの接続パス、検証すべきFlatkeyのベースURL、モデルフィルターを使用するタイミング、curlプリフライトの実行方法、そしてより多くのユーザーにセットアップを展開する前に記録すべき事項を示します。

出典注記： これは2026年6月29日に、公式のOpen WebUI OpenAI互換ドキュメント、ライブのFlatkeyホームページ、およびライブのFlatkey価格ページと照合して確認されました。このランタイムではライブのFlatkey APIキーやOpen WebUIインスタンスは利用できなかったため、以下のコマンドはご自身のキー、モデルエイリアス、およびOpen WebUIデプロイメントで実行するためのテンプレートです。

クイックアンサー：Flatkey用のOpen WebUI OpenAI APIベースURL

Flatkeyルートの場合、Open WebUI OpenAI APIベースURLをアカウントの現在のFlatkeyプロバイダーベースURLに設定します。この記事のために確認した公開されているFlatkeyホームページには、OpenAI互換クライアントをhttps://console.flatkey.ai/v1に向けるように記載されています。Open WebUIでは、そのベースURLを使用し、Flatkey APIキーを貼り付け、モデル検出がノイズが多いか失敗した場合は正確なFlatkeyモデルIDを追加し、接続を保存します。

要約すると、URL、キー、モデルフィルターを設定し、チャットリクエストをテストして、リクエストがFlatkeyの使用状況に表示されることを確認します。このOpen WebUI OpenAI APIベースURLガイドの残りの部分では、それを再現可能なセットアップとトラブルシューティングのチェックリストにしています。

現在のOpen WebUIドキュメントで確認できること

Open WebUIの公式OpenAI互換ガイドによると、Open WebUIはOpenAI互換APIを実装する任意のサーバーまたはプロバイダーに接続できます。ドキュメントでは、統合はプロバイダーごとにカスタムモジュールを使用するのではなく、標準プロトコル、特にOpenAI Chat Completionsプロトコルを中心に構成されています。これにより、FlatkeyはベースURL、キー、およびモデル選択の設定タスクとなります。

同じガイドには、現在の管理者パスが示されています。Open WebUIを開き、Admin Settings、Connections、OpenAIの順に進み、Add Connectionをクリックします。そこから、プロバイダーのURLとAPIキーを入力します。自動モデル検出が機能しない場合は、Model IDs (Filter)にモデルIDを追加して保存します。

Open WebUIの警告の1つは、ルーターのセットアップにとって特に重要です。接続が追加されると、Open WebUIは標準のベアラートークンを使用してプロバイダーの/modelsエンドポイントを介してそれを検証します。ドキュメントによると、一部のプロバイダーは/modelsを実装していないか、非標準の動作を使用するか、扱いにくいモデルリストを返します。モデルリストのエラーは、チャット補完に互換性がないことを自動的に意味するわけではありません。これは、モデルIDを手動で追加し、チャットエンドポイントを直接テストする必要がある場合があることを意味します。

完全な互換性のために、Open WebUIは推奨として/v1/modelsを、必須のコアチャットエンドポイントとして/v1/chat/completionsをリストしています。また、temperature、top_p、max_tokensまたはmax_completion_tokens、stop、seed、logit_biasなどの一般的なOpenAIパラメータも渡します。モデルとサーバーがtoolsとtool_choiceをサポートしている場合、ツールの使用がサポートされます。

Open WebUIを変更する前に確認すべきFlatkeyの値

2026年6月29日に確認されたFlatkeyのホームページには、One API gateway for production AI teamsというタイトルがあり、統一されたモデルアクセス、ルーティング、請求、使用状況分析、および運用管理について説明しています。また、チームはOpenAI互換クライアントをhttps://console.flatkey.ai/v1に向け、既存のSDKまたはクライアントパターンを維持する必要があるとも記載されています。

同日に確認したFlatkeyの料金ページによると、公開カタログには23のプロバイダーにわたる633の有効なモデルがあります。また、/v1/chat/completions、/v1/responses、/v1/messages、/v1/images/generations、/v1/video/generationsなどのエンドポイントファミリーも公開しています。Open WebUIチャットでは、チャット補完パスを通じて利用可能で、使用予定のキーで承認されているモデルから始めてください。

すべてのカタログモデルが優れたOpen WebUIモデルであると想定しないでください。Open WebUI OpenAI APIベースURLはルーターを指しますが、ユーザーエクスペリエンスは、選択したモデルエイリアス、エンドポイントのサポート、レイテンシ、コンテキストの動作、ツールのサポート、そしてモデルがOpen WebUIのモデルセレクターにきれいに表示されるかどうかによって異なります。

ステップバイステップ：OpenAI接続としてFlatkeyを追加する

1. Open WebUIのスコープを選択します。 これが管理者全体の接続なのか、テストインスタンスなのか、それとも環境変数を通じて管理されるセルフホスト型のデプロイメントなのかを決定します。
2. Flatkeyキーを作成または選択します。 Open WebUIテストには専用のキーを使用し、使用状況を追跡して上限を設定できるようにします。
3. 開始モデルを1つ選択します。 Flatkeyの料金ページ、Flatkeyコンソール、またはアカウントで表示可能なモデルリストから、正確なモデルエイリアスをコピーします。
4. 接続画面を開きます。 Open WebUIで、Admin Settings > Connections > OpenAI > Add Connectionに移動します。
5. Flatkey URLを貼り付けます。 アカウントで確認できる場合は、https://console.flatkey.ai/v1を使用します。値には/v1を含める必要がありますが、/chat/completionsは含めません。
6. Flatkeyキーを貼り付けます。 このOpen WebUIデプロイメント用に作成したキーを使用し、個人のプロバイダーキーや無関係なアップストリームプロバイダーキーは使用しないでください。
7. 必要に応じてモデルIDを追加します。 モデルの検出に失敗した場合、オプションが多すぎる場合、またはポリシー外のモデルが公開されている場合は、承認された正確なエイリアスをModel IDs (Filter)に追加します。
8. 保存し、以前のルートを近くに保持します。 Open WebUIでは接続の有効/無効を切り替えられるため、テスト中はロールバック用のルートを保持しておきます。
9. 低リスクのプロンプトを1つ実行します。 Open WebUIで簡単なプロンプトを使用し、Flatkeyの使用状況でタイムスタンプ、キー、モデル、トークン数、コストによってリクエストを確認します。
10. 所有者を文書化します。 アクセスを拡大する前に、誰がキーを所有しているか、誰がローテーションできるか、どのモデルが承認されているか、どのクォータが適用されるかを記録します。

オプションの環境変数テンプレート

デプロイメントが環境変数を通じて管理されている場合は、お使いのOpen WebUIのバージョンとデプロイメント方法でサポートされている名前を使用してください。Open WebUIのプロバイダーの例では、OpenAI互換バックエンド用のOPENAI_API_BASE_URLとOPENAI_API_KEYのパターンが示されていますが、管理パネルでも接続を管理できます。これをデプロイメントテンプレートとして扱い、お使いのバージョンで検証してください。

OPENAI_API_BASE_URL=https://console.flatkey.ai/v1
OPENAI_API_KEY=fk_replace_with_flatkey_key

埋め込み、画像生成、音声、その他のOpenAIスタイルの機能をOpen WebUI経由でルーティングする場合は、Flatkeyと選択したモデルがそのエンドポイントファミリーをサポートしていることを確認した後にのみ、それらの機能固有のベースURLとキー変数を設定してください。最初のOpen WebUI OpenAI APIベースURLの展開では、テストをチャット補完に集中させてください。

Open WebUIを疑う前にFlatkeyルートを事前チェックする

curlによる事前チェックは、ルーターや認証情報の問題をOpen WebUIのUIの問題から切り分けます。これをOpen WebUIサーバーと同等のネットワークロケーションから実行してください。

export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_OPEN_WEBUI_MODEL="replace-with-flatkey-model-alias"

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Return the word ok."
      }
    ],
    "stream": false,
    "max_tokens": 16
  }'

そのリクエストが失敗した場合は、再度Open WebUIを変更する前に、Flatkeyのキー、URL、モデルエイリアス、アカウントの権限、またはネットワークルートを修正してください。成功した場合は、Open WebUIで繰り返し、Flatkeyの使用状況ログを比較してください。

ストリーミングチャット体験のためには、ストリーミングを別途テストしてください。非ストリーミング応答は、ルートが応答できることを証明します。しかし、リバースプロキシ、Open WebUIデプロイメント、およびクライアントブラウザがバッファリングやタイムアウトなしでストリーミングを処理できることを証明するものではありません。

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Stream three short bullet points."
      }
    ],
    "stream": true,
    "max_tokens": 96
  }'

モデル検出とフィルターのチェックリスト

最も安全なOpen WebUI OpenAI APIベースURLの設定では、意図的にモデルフィルターを使用します。ルーターは多くのモデルを公開できますが、広範なモデルリストは、管理者がユーザーに見せたいものとは限りません。

最初にデバッグすべき障害モード

Open WebUIとFlatkeyの本番運用手順書

より広範なグループに対してOpen WebUI OpenAI APIベースURLの変更を行う前に、所有権、ロールバック、コストレビューをサポートする運用上の事実を書き留めてください。

Flatkeyツール統合クラスターにおける位置づけ

Open WebUIは、OpenAI互換ルートを使用できる数あるインターフェースの1つにすぎません。チームが複数のツールを標準化している場合は、クラスター全体で同じパターンを使用します。つまり、1つの現在のベースURL、インターフェースごとに1つのアカウント所有キー、正確なモデルエイリアス、小規模なスモークテスト、使用状況の証明、およびロールバックノートです。

関連するセットアップについては、デスクトップクライアントのベースURL規律に関するCherry Studio APIセットアップガイド、開発者ツールルーティングに関するCC Switch Claude Code Flatkeyガイド、およびベースURLの変更、モデルエイリアスの検証、ロールバックに関するより広範なOpenAI互換API移行プレイブックを参照してください。Flatkeyの価格で現在のモデルとエンドポイントのカバレッジを確認し、最初のOpen WebUI展開を所有するワークスペースのキーを取得してください。

よくある質問

Open WebUIのOpenAI APIベースURLフィールドには何を入力すればよいですか？

アカウントから現在のFlatkeyプロバイダーのベースURLを使用してください。2026年6月29日に確認された公開Flatkeyホームページでは、OpenAI互換クライアントはhttps://console.flatkey.ai/v1を指しています。ベースURLフィールドに完全な/chat/completionsパスを含めないでください。

なぜOpen WebUIはモデル検出エラーを表示するのですか？

Open WebUIは、/modelsを呼び出すことで、新しいOpenAI互換の接続を検証します。公式ドキュメントでは、一部のプロバイダーがそのエンドポイントを実装していない、非標準の動作をする、または非常に大きなモデルリストを返すことがあると警告しています。チャット補完が機能する場合は、正確なモデルIDをフィルターに追加して、再度テストしてください。

すべてのFlatkeyモデルをOpen WebUIに公開できますか？

技術的には、ルーターは多くのモデルを公開できますが、本番環境の管理者は、絞り込んだ許可リストから始めるべきです。Open WebUIのチャットのニーズ、エンドポイントのサポート、レイテンシーの期待値、使用ポリシー、予算管理に合致するモデルを選択してください。

FlatkeyはOpen WebUIの設定を置き換えますか？

いいえ。Flatkeyは、OpenAI互換のルート、キー、モデルアクセス、使用状況の可視性、および請求管理を提供します。Open WebUIは、引き続き独自の接続設定、モデルセレクター、ユーザーアクセス、プロンプトの動作、およびデプロイメントレベルのネットワークを制御します。

セットアップが機能していることを確認するにはどうすればよいですか？

/chat/completionsに対してcurlプリフライトを実行し、Open WebUI接続を保存し、安全なプロンプトを1つ送信して、リクエストがFlatkeyの使用状況に期待されるキー、モデル、タイムスタンプ、トークン、ステータス、コストとともに表示されることを確認します。

最終チェックリスト

• 現在のアカウントソースからFlatkeyベースURLが確認されていること。
• Open WebUIデプロイメント用に専用のFlatkeyキーが作成されていること。
• 承認済みのチャットモデルエイリアスが1つ最初に選択されていること。
• Open WebUI OpenAI APIベースURLが、完全なエンドポイントではなく、プロバイダーのベースURLに設定されていること。
• 検出が失敗した場合やオプションが多すぎる場合は、モデルIDが手動で追加されていること。
• 非ストリーミングおよびストリーミングチャットがテストされていること。
• 最初のOpen WebUIプロンプトの後にFlatkeyの使用状況の行が確認されていること。
• 所有者、クォータ、モデル許可リスト、およびロールバックパスが記録されていること。

これらのチェックに合格すると、Open WebUI OpenAI APIベースURLは単なる接続フィールド以上のものになります。それは、1つのキー、承認されたモデル、使用状況の可視性、そして明確なロールバック計画を備えた、制御されたFlatkeyルートになります。