BroadRouter
始める

ベース URL(base URL)

更新日

ベース URL とは、https://api.example.com/v1 のような API の固定のルートアドレスで、クライアントが /chat/completions などのエンドポイントパスの前に付けます。OpenAI 互換の SDK では、API キーとモデル ID と一緒にベース URL を変えるだけで、同じコードを別のプロバイダーに向けられます。

別名: ベース URL、ベースURL、base_url、エンドポイント URL、API のベース URL、base URL、API base URL、api_base、baseURL、OPENAI_BASE_URL、endpoint URL

SDK が送るリクエストはすべて、ベース URL にパスを足したものです。ベース URL さえ正しければ、クライアントのほかの部分は変更なしで動きます。

しくみ

クライアントは 2 つの部分をつなげます。

部分 例
ベース URL https://inference.broadnet.ai/v1
エンドポイントパス /chat/completions
リクエストの完全な URL https://inference.broadnet.ai/v1/chat/completions

コード上のパラメーター名は、ライブラリによって異なります。

# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });

どちらの公式 SDK も、指定がなければ環境変数 OPENAI_BASE_URL を使い、それもなければ OpenAI 自身のアドレスを使います。ほかのツールでは api_base や OPENAI_API_BASE などの名前が使われます。

なぜ重要か

OpenAI 互換 API を置き換えるだけで使えるのは、ベース URL のおかげです。ベース URL は、プロンプトの送り先と請求元も決めます。値を間違えると、トラフィックと API キーを誤ったプロバイダーに送ってしまうおそれがあります。複数の場所にハードコードせず、キーと一緒に設定ファイルで管理してください。

ルーターも同じ考え方です。ベース URL をモデルのプロバイダーではなくルーターに向けます。

BroadNet Inference の場合

ベース URL は、チャット、ビジョン、音声認識のすべてのモデルで https://inference.broadnet.ai/v1 です。チャットは /chat/completions に、文字起こしは /audio/transcriptions に送ります。最初のリクエストは curl クイックスタートに、フレームワークでの設定箇所は LangChain のガイドにあります。

よくある間違い

  • /v1 がない。 /v1 を付けずに https://inference.broadnet.ai とすると、SDK から 404 エラーが返ります。
  • パスの重複。 .../v1/chat/completions のような完全なエンドポイントをベース URL に貼り付けると、SDK は .../chat/completions/chat/completions を呼び出します。
  • 残っている環境変数。 シェルに古い OPENAI_BASE_URL が残っていると、想定した値が上書きされます。リクエストが違う場所に届くときは、値を表示して確認してください。
  • HTTP のまま。 必ず https:// を使ってください。Bearer キーは TLS 経由で送る必要があります。
  • URL だけ変えてモデルを変えない。 プロバイダーごとに broadnet/deepseek-v4.1-flash のような独自のモデル ID があります。

アプリ全体を移行する場合は、移行チェックリストを順に確認してください。

よくある質問

ベース URL は /v1 で終わるべきですか?

OpenAI 互換の SDK では、プロバイダーのパスが /v1 で始まる場合はそうです。SDK はそのあとに /chat/completions などのパスを付けます。正確な値はプロバイダーのドキュメントで確認してください。

コードを変えずにベース URL を設定できますか?

はい。OpenAI の公式 Python SDK と Node SDK は、ベース URL を渡さない場合に環境変数 OPENAI_BASE_URL を読み込みます。Aider の OPENAI_API_BASE のように、独自の変数名を使うツールもあります。

BroadNet Inference のベース URL は何ですか?

https://inference.broadnet.ai/v1 です。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く