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 があります。
アプリ全体を移行する場合は、移行チェックリストを順に確認してください。