BroadRouter
始める

OpenAI 互換 API の base_url 一覧:14 社を公式ドキュメントで確認

BroadNet Inference チーム · 約 6 分で読めます · 公開日

OpenAI 互換 API なら OpenAI SDK をそのまま使い、base_url と API キーの 2 つを変えるだけで済みます。ベース URL はプロバイダーごとに異なり、Groq は https://api.groq.com/openai/v1、OpenRouter は https://openrouter.ai/api/v1、BroadNet Inference は https://inference.broadnet.ai/v1 です。パス、モデル ID、対応パラメータは異なるので、切り替え前に 1 リクエスト試してください。

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 やエンドポイント一覧は変わるので、本番に出す前に各プロバイダーのドキュメントと私たちの表を照らし合わせてください。

よくある質問

OpenAI API のベース URL は何ですか?

https://api.openai.com/v1 です。baseURL も環境変数 OPENAI_BASE_URL も設定しない場合、公式の Node SDK はこの URL を使います。

base_url は /v1 と /chat/completions のどちらで終えるべきですか?

プロバイダーのドキュメントが終えている位置で終えてください。通常は /v1 です。SDK が /chat/completions を自動で付けるので、ベース URL がすでに /chat/completions で終わっていると 404 になります。

ベース URL は環境変数で設定できますか?

はい。公式の OpenAI SDK はどちらも OPENAI_BASE_URL を読み込み、それを基に作られた多くのツールも同様です。あわせて OPENAI_API_KEY も設定してください。独自の変数名を使うツールもあるので、各ツールのドキュメントも確認してください。

Claude API は OpenAI 互換ですか?

一部互換です。Anthropic は OpenAI SDK 向けに https://api.anthropic.com/v1/ を提供していますが、このレイヤーは主にモデルのテストと比較のためのもので、長期的な本番利用向けではないとしています。ツールの strict は無視され、音声とファイルの入力は拒否されます。

BroadNet Inference はどのエンドポイントに対応していますか?

ドキュメントには POST /v1/chat/completions と POST /v1/audio/transcriptions が記載されています。embeddings、画像生成、Responses API は記載されていません。

OpenAI では動くリクエストが、ほかのプロバイダーで失敗するのはなぜですか?

多くの場合、モデル ID の形式が違うか、プロバイダーが受け付けないパラメータを送っています。たとえば Groq は logprobs、logit_bias、top_logprobs、messages[].name に 400 を返します。任意のパラメータを外し、プロバイダーの正確なモデル ID で再試行してください。

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