OpenAI 互換 API は OpenAI の API と同じ形式のリクエストを受け付けるので、base_url と API キーを変えれば公式の OpenAI SDK がそのまま動きます。厄介なのは、エンドポイントの場所がプロバイダーごとに少しずつ違うことです。下の表には 14 社を載せており、いずれも 2026 年 11 月 15 日に各社の公式ドキュメントから読み取ったものです。
OpenAI 互換プロバイダーごとのベース URL は?
| プロバイダー | ベース URL | OpenAI 互換ドキュメントの記載内容 | ドキュメントに書かれた注意点 |
|---|---|---|---|
| OpenAI | https://api.openai.com/v1 |
すべて(これが基準) | 何も設定しない場合の SDK のデフォルト |
| Anthropic | https://api.anthropic.com/v1/ |
chat completions | “Primarily intended to test and compare model capabilities”(訳:主にモデルの能力をテスト・比較するためのもの)。strict は無視され、音声とファイルの入力は 400 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
chat completions、embeddings、画像生成、models、batch | OpenAI ライブラリのサポートは “still in beta”(訳:まだベータ版)。Responses API の記載なし |
| DeepSeek | https://api.deepseek.com |
chat completions | バージョンパスなし。Anthropic 形式用の URL が別途 /anthropic にある |
| Groq | https://api.groq.com/openai/v1 |
chat completions、Responses API、音声の文字起こしに関する注記 | logprobs、logit_bias、top_logprobs、messages[].name は 400。n は 1 のみ。srt や vtt の文字起こしは非対応 |
| Together AI | https://api.together.ai/v1 |
chat、completions、画像、音声合成、文字起こし、models、Responses | 米国内のみで推論する https://us-api.together.ai/v1 がある。embeddings は専用エンドポイントのみ |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
chat completions | モデル ID は accounts/fireworks/models/… の形式。指定しない限り、エラーを返さずに max_tokens をコンテキストに収まるよう引き下げる |
| DeepInfra | https://api.deepinfra.com/v1/openai |
chat completions。Responses のクライアントも同じベースを使用 | embeddings、画像、音声は別ページに記載 |
| Mistral AI | https://api.mistral.ai/v1 |
POST /v1/chat/completions |
API リファレンスは OpenAI 互換をうたっていない。頼る前にテストが必要 |
| OpenRouter | https://openrouter.ai/api/v1 |
chat completions | ランキング用に任意の HTTP-Referer と X-OpenRouter-Title ヘッダーがある |
| xAI | https://api.x.ai/v1 |
Responses API | ガイドに “The Responses API is the preferred way of interacting with our models”(訳:Responses API が当社モデルを利用する推奨の方法)とある |
| Z.ai(GLM) | https://api.z.ai/api/paas/v4/ |
chat completions | パスは v1 ではなく v4 |
| Alibaba Model Studio | https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1(シンガポール) |
chat completions | ホスト名にワークスペース ID が入る。キーは作成したリージョンでしか使えず、それ以外では 401 |
| BroadNet Inference | https://inference.broadnet.ai/v1 |
chat completions、音声の文字起こし | モデル ID は broadnet/ で始まる。詳細は後述 |
Alibaba は us-east-1 の米国(バージニア)エンドポイントも記載しています。同じページの北京の行にはシンガポールのホストが表示されている一方、ページ内のほかの記述では cn-beijing となっているため、中国のエンドポイントはコンソールで確認してください。この表はある時点のスナップショットです。エンドポイントは変わります。実際、確認作業中に Anthropic と Google のドキュメントはどちらも新しいアドレスへリダイレクトされました。
これらのプロバイダーの料金は プロバイダー別 LLM API 料金のページをご覧ください。
コードでベース URL を設定するには?
Python では、クライアントに base_url を渡します。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://inference.broadnet.ai/v1",
api_key=os.environ["BROADNET_API_KEY"],
)
r = client.chat.completions.create(
model="broadnet/gemma-4-26b-a4b",
messages=[{"role": "user", "content": "Say hello in one line."}],
)
print(r.choices[0].message.content)
Node では、オプション名は baseURL です。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://inference.broadnet.ai/v1",
apiKey: process.env.BROADNET_API_KEY,
});
公式 SDK を使うすべてのツールに対して、一度にまとめて設定することもできます。Node SDK のソースでは、baseURL のデフォルトは process.env['OPENAI_BASE_URL']、それがなければ https://api.openai.com/v1 です。Python の README にも同じ変数が記載されています。
export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"
詳しい手順:OpenAI Python SDK、OpenAI Node SDK。ベース URL とは何か、なぜツールがそれを求めるのかは用語集をご覧ください。
新しいベース URL を curl でテストするには?
アプリケーションのコードを変える前に、ごく小さなリクエストを 1 つ送ってみましょう。
curl https://inference.broadnet.ai/v1/chat/completions \
-H "Authorization: Bearer $BROADNET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'
ベース URL、キー、モデルを、テストするプロバイダーのものに置き換えてください。choices 配列付きの 200 が返れば、パス、キー、モデル ID はすべて正しいということです。404 はたいていパスの誤り、401 はキーかリージョンの誤りです。400 では、プロバイダーが受け付けないパラメータ名が示されることがよくあります。curl クイックスタートにほかの例があり、API リクエストビルダーを使えば curl、Python、Node の各バージョンを自動で作成できます。
base_url を変えるときによくある間違いは?
- **エンドポイントを丸ごと貼り付ける。**SDK は
/chat/completionsを付け足します。ベース URL がすでにそれで終わっていると/chat/completions/chat/completionsとなり、404 になります。 - **習慣で
/v1を付けたり外したりする。**DeepSeek のドキュメントにあるベースには/v1がなく、Z.ai は/v4/、Gemini は/v1beta/openai/で終わります。プロバイダーの文字列をそのままコピーしてください。 - OpenAI のモデル名を使い続ける。
gpt-…という名前はほかでは通りません。プロバイダーごとに形式があり、DeepInfra ではdeepseek-ai/DeepSeek-V4-Flash-0731、Fireworks ではaccounts/fireworks/models/…、BroadNet ではbroadnet/deepseek-v4.1-flashです。 - **プロバイダーが拒否または無視するパラメータを送る。**Groq は
logprobsに 400 を返し、Anthropic のレイヤーはseed、logit_bias、reasoning_effortを黙って無視します。黙って無視されるパラメータはエラーより厄介です。何も知らせてくれないからです。 - **レスポンスのフィールドが同じだと思い込む。**Anthropic のレイヤーは空の
prompt_tokens_detailsを返すので、キャッシュトークンの報告がありません。Fireworks はストリーミングの使用量を最後のチャンクに入れますが、SDK の型定義には宣言されていない場合があります。 - すべてのエンドポイントがあると思い込む。「OpenAI 互換」は通常 chat completions のことです。表のとおり、embeddings、音声、画像生成、Responses API は別に確認が必要です。
- **リージョンを混在させる。**Alibaba のキーはリージョンに紐づいており、Together には米国専用のホストが別にあります。有効なキーでも、ホストを間違えれば失敗します。
切り替え前の完全なチェックリストは OpenAI 互換 API 移行チェックリストにあります。
BroadNet Inference はどのエンドポイントに対応しているか?
BroadNet の API リファレンスには、https://inference.broadnet.ai/v1 上のモデル用エンドポイント 2 つと、カタログのメタデータを返す GET /v1/models が記載されています。
| エンドポイント | モデル |
|---|---|
POST /v1/chat/completions |
DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B、BroadNet Gemma 4 VL 26B |
POST /v1/audio/transcriptions |
BroadNet Transcribe Arabic、BroadNet Transcribe(14 言語) |
実際の使い方では、次のことを意味します。
- **embeddings、画像生成、Responses API はドキュメントにありません。**これらのいずれかが必要なツールでは、その部分に別のプロバイダーが必要です。
- ツール呼び出しと構造化出力は GLM 5.3 と Qwen3.8 27B について記載されています。
- 画像は
data:URL として、image_urlコンテンツパートに入れて送ります。DeepSeek V4.1 Flash、Qwen3.8 27B、Gemma 4 VL 26B が対象です。 - 推論モデル(DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B)では、推論が
max_tokensに含まれます。ドキュメントの推奨どおり 1,000 トークン以上を確保するか、reasoning_effortをlowにしてください。推論モデルが空の回答を返す理由もご覧ください。 - **モデル一覧は応答しました。**2026 年 11 月 15 日に
GET /v1/modelsを呼び出すと応答がありましたが、記載されたエンドポイントの一覧には含まれていないので、これに依存した作りにはしないでください。 - 制限は、従量課金キーで毎分 30 リクエスト、同時実行 4 リクエストです。
100 万トークンあたりの料金:DeepSeek V4.1 Flash は入力 $0.175、出力 $0.52、Gemma 4 VL 26B は $0.10 と $0.22 です。DeepSeek V4.1 Flash は定額プランでも販売されており、1 セッションあたり月 $60(同時に 1 リクエスト)です。
複数のプロバイダーを 1 つのベース URL にまとめるべきか?
アプリがこれらのプロバイダーをいくつも呼び出すなら、LiteLLM のようなプロキシを使うと、コードからは 1 つのベース URL だけを扱い、モデル名を各アップストリームに対応づけられます。対応づけは自分で決めます。フォールバックを自分で設定しない限り、何かが勝手にプロバイダーを切り替えることはありません。クライアントや LiteLLM での方法は LLM API のフェイルオーバーで解説しています。LiteLLM プロキシガイドには BroadNet の設定例があります。用語の背景は OpenAI 互換 API をご覧ください。
BroadNet Inference が合う場面
すでに chat completions 形式のコードがあり、オープンモデル、アラビア語や多言語の音声認識、定額の DeepSeek セッションを 1 つのキーで使いたいなら、BroadNet が合います。同じプロバイダーで embeddings、Responses API、画像生成が必要なら合いません。Together AI と Gemini は OpenAI の API をより幅広くドキュメント化しています。これらの URL やエンドポイント一覧は変わるので、本番に出す前に各プロバイダーのドキュメントと私たちの表を照らし合わせてください。
