---
title: "OpenAI 互換 API への切り替え：移行チェックリスト | BroadRouter"
description: "base_url の変更は一番簡単な部分です。問題が起きるのはモデル ID、推論トークン、ストリーミングの使用量、エラー、レート制限、キーです。コード付きのチェックリストです。"
url: https://broadrouter.com/ja/blog/openai-compatible-api-migration-checklist/
lang: ja
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。 [英語の原文を読む](https://broadrouter.com/blog/openai-compatible-api-migration-checklist/) (2026-11-16 更新).

# OpenAI 互換 API への移行チェックリスト

BroadNet Inference チーム · 約 5 分で読めます · 公開日 2026-11-14 · 更新日 2026-11-16

OpenAI 互換 API に移るには、3 つの設定（base\_url、api\_key、model）を変え、違いを確認します。確認するのは、モデル ID、推論トークンの max\_tokens への算入、ストリーミングでの使用量の返し方、リトライすべきエラー、レート制限、キーのセキュリティです。BroadNet Inference のベース URL は https://inference.broadnet.ai/v1 です。

## 要点

-   変える設定は 3 つです：`base_url`、`api_key`、`model`。
-   切り替える前に、アプリが使っているエンドポイントとフィールドをすべて洗い出し、切り替え後に 1 つずつテストしてください。
-   推論モデルは思考を `max_tokens` に算入します。上限が小さいと回答が空になります。
-   ストリーミングでは `stream_options` で使用量を要求してください。そうしないとコスト追跡が見えなくなります。
-   本番トラフィックを移す前に、各エラーコードをリトライか修正かに振り分けておいてください。
-   切り替える前に、新旧のプロバイダーを実トラフィックで 1 日並行稼働させてください。

**このページの内容**

1.  0\. アプリはいま何を使っていますか？
2.  1\. 変える 3 つの設定は何ですか？
3.  2\. 新しいモデル ID は何ですか？
4.  3\. 切り替えると回答が空になるのはなぜですか？
5.  4\. ストリーミングでも使用量は返りますか？
6.  5\. どのエラーをリトライすべきですか？
7.  6\. 新しいレート制限はどうなりますか？
8.  7\. プロンプトは収まりますか？
9.  8\. キーとデータ保持はどうしますか？
10.  9\. 安全に切り替えるには？
11.  よくある移行ミスは何ですか？
12.  BroadNet Inference の位置づけ

いまではほとんどの LLM プロバイダーが [OpenAI API 形式](https://broadrouter.com/ja/glossary/openai-compatible-api/)に対応しています。そのため切り替えは 1 行の変更に見えますし、最初の回答を得るだけならそのとおりです。本番トラフィックを流すなら、このリストを順に確認してください。どの項目も、実際に移行が失敗したパターンから来ています。

## 0\. アプリはいま何を使っていますか？

何かを変える前に、アプリが依存しているものを書き出します。コードから SDK の呼び出しをすべて検索し、一覧にしてください。OpenAI の Whisper API を呼んでいる場合、OpenAI は `whisper-1` を 2027 年 2 月 26 日に提供終了と告知しています。音声側は [Whisper API の代替](https://broadrouter.com/ja/blog/whisper-api-alternative/)で扱っています。

| 機能 | 探す場所 | 切り替え後のテスト |
| --- | --- | --- |
| Chat completions | すべての `chat.completions.create` | 同じプロンプトで回答を比較 |
| ストリーミング | `stream=True` | チャンクが届き、`[DONE]` で終わり、使用量がある |
| ツール呼び出し | `tools=` | ツール呼び出しがパースされ実行される |
| 構造化出力 | `response_format=` | JSON がスキーマで検証を通る |
| 画像 | メッセージ内の画像パート | モデルが受け付ける |
| 音声の文字起こし | `audio.transcriptions` | テキストと言語が正しい |
| Embeddings、ファイル、バッチ | その他のエンドポイント | そもそもプロバイダーが提供しているか確認 |

最後の行が重要です。「OpenAI 互換」がまずカバーするのは、たいてい chat completions です。BroadNet Inference のカタログでは、チャットモデルは `/v1/chat/completions`、音声認識モデルは `/v1/audio/transcriptions` で提供されています。ほかのエンドポイントを使っている場合は、現在のプロバイダーに残すか、代わりを探してください。

## 1\. 変える 3 つの設定は何ですか？

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
```

[ベース URL](https://broadrouter.com/ja/glossary/base-url/) の設定名はライブラリによって違います。Python SDK と LangChain の ChatOpenAI では `base_url`、Node.js SDK では `baseURL` です。[README](https://github.com/openai/openai-python) によると、Python SDK は環境変数 `OPENAI_BASE_URL` も読み込みます。環境に古い値が残っていないか確認してください。残っていると、エラーなしでリクエストが以前のプロバイダーに送られることがあります。

[API キー](https://broadrouter.com/ja/glossary/api-key/)はコードに書かず、環境変数かシークレットマネージャーに置いてください。SDK ごとの設定方法：[Python](https://broadrouter.com/ja/guides/openai-python-sdk/)、[Node.js](https://broadrouter.com/ja/guides/openai-node-sdk/)、[LangChain](https://broadrouter.com/ja/guides/langchain-openai-base-url/)。最初のリクエストを手で組み立ててテストするなら、[API リクエストビルダー](https://broadrouter.com/tools/api-request-builder/)を使ってください。既存のコードにベース URL、キー、モデルの変更を反映するには、[OpenAI から BroadNet への移行ヘルパー](https://broadrouter.com/tools/openai-to-broadnet-migration/)にコードを貼り付けてください。確認すべき点も一覧にしてくれます。

## 2\. 新しいモデル ID は何ですか？

モデルの名前の付け方はプロバイダーごとに違います。BroadNet Inference では次のとおりです。

| モデル | ID |
| --- | --- |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` |
| GLM 5.3 | `broadnet/glm-5.3` |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` |
| Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` |

モデル ID はコードではなく設定に置いてください。そうすれば、あとで切り替えるときは書き直しではなくデプロイだけで済みます。各モデルの制限と料金はそれぞれのページにあります：[DeepSeek V4.1 Flash](https://broadrouter.com/ja/models/deepseek-v4.1-flash/)、[GLM 5.3](https://broadrouter.com/ja/models/glm-5.3/)、[Qwen3.8 27B](https://broadrouter.com/ja/models/qwen3.8-27b/)、[Gemma 4 VL 26B](https://broadrouter.com/ja/models/gemma-4-vl-26b/)。

## 3\. 切り替えると回答が空になるのはなぜですか？

これが最もよくある想定外の事態です。DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B は回答の前に推論し、**[推論トークン](https://broadrouter.com/ja/glossary/reasoning-tokens/)は [`max_tokens`](https://broadrouter.com/ja/glossary/max-tokens/) に算入されます**。推論しないモデルでは十分だった 256 という上限が思考だけで使い切られ、回答が空で返ってくることがあります。1,000 トークン以上を確保するか、単純なタスクでは `reasoning_effort` を `low` にしてください。[詳しい説明](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。

## 4\. ストリーミングでも使用量は返りますか？

[ストリーミング](https://broadrouter.com/ja/glossary/streaming/)は Server-Sent Events を使い、`data: [DONE]` で終わります。トークン使用量は、要求した場合にだけ最後のチャンクに含まれます。

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash", messages=messages,
    stream=True, stream_options={"include_usage": True},
)
```

これがないと、コストのダッシュボードはゼロを示します。`[DONE]` の前にストリームが終わった場合は、不完全として扱ってください。[ストリーミングガイド](https://broadrouter.com/ja/guides/streaming-chat-completions/)。

## 5\. どのエラーをリトライすべきですか？

| ステータス | 意味 | 対応 |
| --- | --- | --- |
| 401 | キーが不正か失効済み、または従量課金の利用枠を使い切った | 修正する。リトライしない |
| 402 | 残高または予算 | チャージする。リトライしない |
| 403 | モデル、ルート、IP のポリシーで拒否 | 不一致を修正する |
| 413 | リクエストが大きすぎる | 小さくする。リトライしない |
| 429 | レート、同時実行数、支出の上限 | バックオフしてリトライ |
| 5xx | サーバー側 | 上限付きバックオフでリトライ |

公式の Python SDK は、すでに一部のエラーをリトライします。README によると、接続エラーと 408、409、429、5xx のレスポンスは、デフォルトで短い指数バックオフにより 2 回リトライされます。`max_retries` を明示的に設定し、この挙動をデフォルト任せではなく自分の判断にしてください。サポートが問題を追跡できるよう、すべてのレスポンスのリクエスト ID をログに残してください。[全コード](https://broadrouter.com/ja/guides/errors-and-retries/)。

## 6\. 新しいレート制限はどうなりますか？

トラフィックが来る前に新しい制限を把握しておいてください。BroadNet の従量課金キーは、1 分あたり 30 リクエスト、同時実行 4 件までです。無制限プランは、セッションごとに同時に 1 リクエストを実行します。ワーカープールをこれに合わせないと、初日から 429 が出ます。規模の計算は[レート制限計算ツール](https://broadrouter.com/tools/llm-rate-limit-calculator/)でできます。[並列エージェント向けの規模設計](https://broadrouter.com/ja/blog/run-parallel-coding-agents-flat-rate/)もご覧ください。

## 7\. プロンプトは収まりますか？

コンテキストウィンドウを確認してください。DeepSeek V4.1 Flash と GLM 5.3 は 1,048,576 トークン、Qwen3.8 27B は 262,144、Gemma 4 VL 26B は 32,768 です。以前のモデルに収まっていたプロンプトが、小さいウィンドウには収まらないことがあります。[コンテキストウィンドウ計算ツール](https://broadrouter.com/tools/context-window-calculator/)で確認してください。[キャッシュ入力の料金](https://broadrouter.com/ja/blog/cached-input-tokens-explained/)の恩恵を受けるには、変わらないプロンプト内容を先頭に置いてください。

## 8\. キーとデータ保持はどうしますか？

本番キーは [IP 許可リスト](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/)でサーバーの IP に限定してください。新しいプロバイダーに何を保持するかを確認してください。[ZDR チェックリスト](https://broadrouter.com/ja/blog/zero-data-retention-llm-api-checklist/)をご覧ください。

## 9\. 安全に切り替えるには？

1.  1 日分の実リクエストのコピーを両方のプロバイダーに送ります。
2.  サンプルの回答に加え、レイテンシ、エラー、リクエストあたりのコストを比べます。
3.  トラフィックの 10% を移し、1 日様子を見てから残りを移します。
4.  以前のプロバイダーを 1 週間フォールバックとして設定したままにします。

多くのサービスを運用している場合、[LiteLLM](https://broadrouter.com/ja/guides/litellm-proxy-custom-provider/) のようなプロキシを使えば、アプリごとではなく 1 か所でプロバイダーを切り替えられます。

## よくある移行ミスは何ですか？

-   \*\*ベース URL に `/v1` がない。\*\*リクエストが 404 になります。完全な URL を使ってください。
-   \*\*設定に古いモデル名が残っている。\*\*新しいプロバイダーはその名前を知りません。
-   \*\*プロバイダー固有のフィールドがリクエストに残っている。\*\*以前のプロバイダーだけが理解していたフィールドは、拒否されるか無視されることがあります。汎用クライアントからは削除してください。
-   \*\*プロンプト 1 つしかテストしない。\*\*ステップ 0 の一覧を使い、機能ごとにテストしてください。
-   \*\*金曜日に切り替える。\*\*実トラフィックを丸 1 日見守る時間を確保してください。

## BroadNet Inference の位置づけ

BroadNet Inference は、OpenAI SDK 経由で chat completions と音声の文字起こしを使うアプリなら、そのまま置き換えられる移行先です。3 つの設定を変え、上のリストを順に確認してください。カタログにあるのはチャットモデルと音声認識モデルだけなので、embeddings やファイルストレージなどほかのエンドポイントに依存している場合は、それらを別のプロバイダーに残してください。新規アカウントには $5 の初回クレジットがあります。チャットモデルのうちこのクレジットで使えるのは Gemma 4 VL 26B だけなので（2 つの Transcribe モデルにも使えます）、DeepSeek、GLM、Qwen でシャドーテストをするにはチャージが必要です。

関連する無料ツール （英語）

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[無料ツール （英語）](https://broadrouter.com/tools/)

## この記事の用語

[エンベディング（埋め込み、embeddings）](https://broadrouter.com/ja/glossary/embeddings/)

エンベディング（埋め込み）とは、テキストや画像などの入力を表すためにモデルが出力する浮動小数点数のリスト（ベクトル）です。意味の近い入力ほどベクトルも近いので、その距離で検索結果の順位付け、文書の分類、関連項目の発見ができます。

[ツール呼び出し（Function Calling、tool calling）](https://broadrouter.com/ja/glossary/tool-calling/)

ツール呼び出し（Function Calling とも呼ばれます）とは、開発者が定義した関数の実行を求める構造化されたリクエストを、モデルが JSON の引数付きで返す LLM API の機能です。関数を実行して結果を返すのはアプリケーションで、モデル自身がコードを実行することはありません。

[トークン（token）](https://broadrouter.com/ja/glossary/token/)

トークンとは、言語モデルが読み書きするテキストの単位です。モデルのトークナイザーが作る単語、単語の一部、句読点、バイト列のいずれかにあたります。LLM API は利用量をトークンで数え、上限を設け、通常はトークン単位で課金します。

[Chat Completions API（チャット補完 API）](https://broadrouter.com/ja/glossary/chat-completions-api/)

Chat Completions API とは、OpenAI の HTTP エンドポイント POST /v1/chat/completions で、モデル名とロール付きメッセージのリストを受け取り、モデルの次のメッセージを返します。そのリクエストと応答の形は、OpenAI 互換のプロバイダーや SDK が使う共通形式になりました。

[ベース URL（base URL）](https://broadrouter.com/ja/glossary/base-url/)

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

[レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/)

レート制限とは、1 分あたりのリクエスト数やトークン数など、一定時間内にクライアントが API を使える量に API 側が設ける上限です。上限を超えたリクエストは、使用量が下回るまで通常 HTTP 429 Too Many Requests で拒否されます。

[指数バックオフ（exponential backoff）](https://broadrouter.com/ja/glossary/exponential-backoff/)

指数バックオフ（exponential backoff）とは、失敗するたびに待ち時間を長くして再試行するリトライ戦略で、通常は上限まで遅延を 2 倍ずつ増やします。各待ち時間にランダムなジッターを加えると、多数のクライアントの再試行が分散し、同時にサーバーへ集中しなくなります。

[同時実行数（concurrency）](https://broadrouter.com/ja/glossary/concurrency/)

同時実行数（concurrency）とは、クライアントが同時に処理中にしているリクエストの数です。開いているリクエストは応答が終わるまで GPU の容量を占有するため、LLM API は毎分リクエスト数とは別に、キーやプランごとにこれを制限することがよくあります。

## よくある質問

### 別の SDK が必要ですか？

いいえ。公式の OpenAI SDK（Python と Node.js）はカスタムのベース URL を受け付けます。それを土台にしたフレームワーク、たとえば LangChain の ChatOpenAI も受け付けます。

### OpenAI SDK でベース URL を変えるにはどうしますか？

Python ではクライアントに base\_url を、Node.js では baseURL を渡すか、環境変数 OPENAI\_BASE\_URL を設定します。BroadNet Inference の値は https://inference.broadnet.ai/v1 で、キーは api\_key に入れます。

### 切り替えたら空の応答が返るのはなぜですか？

DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B のような推論モデルは回答の前に考え、その思考が max\_tokens に算入されます。max\_tokens を 1,000 以上に上げるか、reasoning\_effort を low にしてください。

### 切り替え後に 404 や model not found エラーが出るのはなぜですか？

たいていは、モデル ID が以前のプロバイダーの名前のままか、ベース URL に /v1 のパスが欠けています。新しいプロバイダーの正確なモデル ID と完全なベース URL を使ってください。

### どのエラーをリトライすべきですか？

429 と 5xx は上限付きの指数バックオフでリトライします。401、402、413 はリトライの前に原因を修正してください。このサイトのエラーガイドに全コードがあります。

### OpenAI 互換は「まったく同じ」という意味ですか？

いいえ。リクエストとレスポンスの形は同じですが、モデル ID、対応パラメーター、制限、使用量フィールド、エラーの詳細は違うことがあります。アプリが使う機能はすべてテストしてください。

## 続けて読む

-   [OpenAI 互換 API の base\_url 一覧：14 社を公式ドキュメントで確認](https://broadrouter.com/ja/blog/openai-compatible-api-base-urls/)
-   [AI エージェントには OpenRouter か定額プランか：安いのはどちら？](https://broadrouter.com/ja/blog/openrouter-alternative-flat-rate/)
-   [100 万トークンのコンテキストウィンドウが役立つとき（役立たないとき）](https://broadrouter.com/ja/blog/million-token-context-window-guide/)
-   [ゼロデータ保持の LLM API：確認すべき 10 の質問チェックリスト](https://broadrouter.com/ja/blog/zero-data-retention-llm-api-checklist/)
-   [BroadNet の GPU ハードウェアとサービング方式（BroadNet の説明による）](https://broadrouter.com/ja/blog/broadnet-gpu-fleet-and-serving/)
-   [LLM API のレスポンスをキャッシュしてコスト削減：Python の完全一致キャッシュ](https://broadrouter.com/ja/blog/cache-llm-responses-cut-cost/)
-   [ガイド：OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [ガイド：OpenAI Node.js SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-node-sdk/)
-   [ガイド：LangChain で BroadNet Inference を使う](https://broadrouter.com/ja/guides/langchain-openai-base-url/)
-   [ガイド：BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)
-   [ガイド：chat completions のストリーミングと接続切断への対処](https://broadrouter.com/ja/guides/streaming-chat-completions/)
-   [ガイド：推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)
-   [ガイド：LiteLLM から BroadNet Inference にルーティングする（SDK とプロキシ）](https://broadrouter.com/ja/guides/litellm-proxy-custom-provider/)

実際のワークロードで試してください。 新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-blog-openai-compatible-api-migration-checklist&utm_content=page-cta) ·

**出典**

-   [BroadNet Inference API リファレンス （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-blog-openai-compatible-api-migration-checklist&utm_content=sources)
-   [OpenAI Python SDK の README（base\_url、OPENAI\_BASE\_URL、リトライ。2026-11-14 確認）](https://github.com/openai/openai-python)
