---
title: "OpenAI Python SDK の base_url を変更して使う（BroadNet） | BroadRouter"
description: "公式の OpenAI Python SDK は、base_url を 1 か所変えるだけで BroadNet Inference に接続できます。インストール、キーの設定、最初のリクエスト、ストリーミングまでを説明します。"
url: https://broadrouter.com/ja/guides/openai-python-sdk/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# OpenAI Python SDK を BroadNet Inference で使う

更新日 2026-11-16

openai パッケージをインストールし、base\_url を https://inference.broadnet.ai/v1、api\_key を BroadNet のキーにしてクライアントを作成します。chat.completions の呼び出しはそのまま動き、変えるのはモデル ID（例：broadnet/deepseek-v4.1-flash）だけです。BroadNet が提供するのはチャット補完と文字起こしで、Responses API はありません。

BroadNet Inference のアカウントと推論キーが必要です。新規アカウントは $5 のクレジット付きで始まり、カードは不要です。[inference.broadnet.ai でアカウントを作成してください](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-python-sdk&utm_content=body)。コンソールにキーが表示されるのは 1 回だけで、保存されるのはハッシュのみなので、すぐに環境変数にコピーしてください。

## 1\. インストールとキーの設定

現在の `openai` パッケージ（3.x）には Python 3.10 以上が必要です。

```bash
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. 最初のリクエスト

次の内容を `first_request.py` として保存します。

```python
from openai import OpenAI
import os

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

response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

`python first_request.py` で実行します。この例で `broadnet/gemma-4-26b-a4b` を使っているのは、無料クレジットで動くからです。ほかのチャットモデルはチャージ後に使えます。

## 3\. 使いたいモデルに切り替える

変えるのは `model` だけです。

| 用途 | モデル ID |
| --- | --- |
| 定額プランで無制限、コンテキスト 1M | `broadnet/deepseek-v4.1-flash` |
| ツールと構造化出力、コンテキスト 1M | `broadnet/glm-5.3` |
| アラビア語のテキストと画像 | `broadnet/qwen3.8-27b` |
| 価格が低く、無料クレジットで使える | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B は回答の前に推論し、その推論も `max_tokens` に数えられます。1,000 トークン以上を割り当ててください。[上限が小さいと空の回答が返る理由はこちら](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。

## 4\. 回答をストリーミングする

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Count from one to three."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)
```

`include_usage` を付けると、トークン数は最後のチャンクで届きます。このチャンクには `choices` がありません。接続が切れた場合の扱いは[ストリーミングのガイド](https://broadrouter.com/ja/guides/streaming-chat-completions/)で説明しています。

## 5\. リクエスト ID を残す

すべてのレスポンスには `X-Request-ID` ヘッダーが付きます。BroadNet のサポートに求められるので、ログに残してください。パース済みのレスポンスでは `response._request_id` として取得できます。ほかのヘッダーと一緒に読むには次のようにします。

```python
raw = client.chat.completions.with_raw_response.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Hi"}],
)
print(raw.headers.get("x-request-id"))
response = raw.parse()
```

従量課金のキーは毎分 30 リクエスト、同時実行 4 リクエストまでです。[各エラーコードの意味とリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)。

## トラブルシューティング

-   **`AuthenticationError`（401）。** キーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。コードを実行するプロセスで `BROADNET_API_KEY` が設定されているか確認してください。
-   **`NotFoundError`（404）。** `base_url` が `/v1` で終わっているか、`responses` ではなく `chat.completions` を呼んでいるかを確認してください。次に、`broadnet/` 接頭辞を含むモデル ID を確認してください。
-   **新しいアカウントで有料モデルが失敗する。** $5 の初回クレジットで使えるのは BroadNet Gemma 4 VL 26B（`broadnet/gemma-4-26b-a4b`）と 2 つの BroadNet Transcribe モデルです。ほかのチャットモデル（DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B）を使うにはチャージしてください。
-   **`content` が空。** 推論は `max_tokens` に数えられます。1,000 以上に上げてください。[回答が空で返る理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **`RateLimitError`（429）。** 毎分または同時実行の上限を超えました。SDK はデフォルトで 2 回リトライします。変えるにはクライアントで `max_retries` を設定してください。
-   **アップグレード後にカスタム HTTP クライアントでエラーが出る。** 3.x の SDK は HTTPX2 を使います。独自の `http_client` を渡している場合は、SDK の HTTPX2 移行ガイドに従ってください。

## このガイドの用語

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

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

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

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

[プリペイドクレジット（prepaid credit）](https://broadrouter.com/ja/glossary/prepaid-credit/)

プリペイドクレジットとは、使用前に API アカウントに入金しておくお金です。リクエストごとに費用が残高から差し引かれ、残高がなくなると、チャージするまで従量課金のリクエストは止まります。支出は支払った額までに抑えられます。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[API キー（API key）](https://broadrouter.com/ja/glossary/api-key/)

API キーとは、API を呼び出すクライアントを識別し、認可するための秘密の文字列です。LLM API では通常 Authorization: Bearer ヘッダーで送り、キーを持つ人は誰でも、そのキーの所有アカウントに課金されるリクエストを送れます。

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

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

[構造化出力（Structured Outputs）](https://broadrouter.com/ja/glossary/structured-output/)

構造化出力とは、モデルの回答を開発者が指定した形式（通常は JSON Schema）に制約し、コードで確実に解析できるようにする LLM API の機能です。有効な JSON であることだけを保証し、特定の形までは保証しない JSON モードより厳格です。

## よくある質問

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

いいえ。BroadNet Inference は OpenAI の chat completions と audio transcriptions の形式に対応しているので、公式の openai パッケージを base\_url だけ変えて使えます。

### OPENAI\_API\_KEY をそのまま使えますか？

使えますが、BROADNET\_API\_KEY という別の変数にしておくと、あるプロバイダーのキーを誤って別のプロバイダーに送るのを防げます。

### SDK は OPENAI\_BASE\_URL を読みますか？

はい。base\_url を渡さなければ、クライアントは OPENAI\_BASE\_URL を使います。これを https://inference.broadnet.ai/v1 に、OPENAI\_API\_KEY を BroadNet のキーに設定すれば、OpenAI() に引数は不要です。

### BroadNet で client.responses.create は使えますか？

いいえ。SDK の README は Responses API を先に紹介していますが、BroadNet のドキュメントにあるのはチャット補完と音声の文字起こしだけです。client.chat.completions.create を使ってください。

## 関連ガイド

-   [OpenAI Node.js SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-node-sdk/)
-   [chat completions のストリーミングと接続切断への対処](https://broadrouter.com/ja/guides/streaming-chat-completions/)
-   [推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)

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

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-python-sdk&utm_content=page-cta) ·

**出典**

-   [BroadNet Inference API リファレンス、最初のリクエスト （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-python-sdk&utm_content=sources#base-url)
-   [PyPI の OpenAI Python ライブラリ（3.x、Python 3.10 以上、2026-11-14 確認）](https://pypi.org/project/openai/)
