---
title: "BroadNet Inference 開発者クイックスタート：Python と cURL | BroadRouter"
description: "Python または cURL で BroadNet Inference に最初のチャットと文字起こしのリクエストを送り、選んだモデルの移行チェックリストを確認します。"
url: https://broadrouter.com/ja/developers/
lang: ja
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# 開発者向け

更新日 2026-11-15

BroadNet Inference は `https://inference.broadnet.ai/v1` で OpenAI のリクエスト形式を使います。コンソールでキーを作成して環境変数に保存し、正確なモデル ID を付けて `/chat/completions` か `/audio/transcriptions` に送信します。本番移行前に、そのモデルのパラメータ、ストリーミング、ツール、上限、エラーを確認してください。

-   チャットのクイックスタート
-   文字起こしのクイックスタート
-   モデル ID
-   移行チェックリスト
-   エラーと再試行
-   ドキュメントとガイド

## 最初のチャットリクエストを送るには？

1.  [inference.broadnet.ai （英語）](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-developers&utm_content=quickstart-account) にログインし、推論用のキーを作成します。キーは一度だけ表示され、コンソールにはハッシュのみが保存されます。
2.  OpenAI SDK をインストールし、シェルでキーを設定します。キーはサーバー側に置き、ブラウザのコードには絶対に含めないでください。
3.  リクエストを送信します。回答は `choices[0].message.content` から読み取ります。

setup

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

first\_request.py

```
import os
from openai import OpenAI

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)
```

request.sh

```
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":"Reply with one short sentence."}]}'
```

この例では BroadNet Gemma 4 VL 26B を使います。US$5 の初回クレジットで利用できます。DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B は先にチャージが必要です。サポートへの問い合わせ用に、レスポンスヘッダーの `X-Request-ID` を控えておいてください。

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### ストリーミング

`stream=true` を設定し、`data: [DONE]` まで Server-Sent Events を読み取ります。`stream_options.include_usage` を指定すると、トークン使用量が最後のチャンクで届きます。`[DONE]` の前にストリームが終わった場合は、回答が不完全なものとして扱ってください。BroadNet は、本番でストリーミングに依存する前にモデルごとに動作を確認するよう求めています。

stream.sh

```
curl -N 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","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count from one to three."}]}'
```

## 音声を文字起こしするには？

WAV または MP3（1 ファイル最大 26,214,400 バイト）を `/audio/transcriptions` に送ります。`language` は必ず指定してください。指定しないと、アラビア語がラテン文字で返ることがあります。アラビア語には `language=ar` を使います。`.ogg` や `.m4a` は先に変換してください：`ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

レスポンスは JSON で、文字起こしテキストは `text` に入ります。[アラビア語モデルか多言語モデルか、音声のコストは](https://broadrouter.com/ja/arabic-transcription/)。

## 使えるモデル ID は？

`model` には正確な ID を渡してください。チャットモデルを探すのに `/v1/models` を頼らず、この一覧か[リファレンス （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-developers&utm_content=models-docs#models)を使ってください。

| モデル | ID | エンドポイント | 入力 | ドキュメント記載 | 利用条件 |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/ja/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | テキスト + 画像 | 推論（reasoning） | チャージが必要 |
| [GLM 5.3](https://broadrouter.com/ja/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | テキスト | ツール呼び出し、構造化出力、推論（reasoning） | チャージが必要 |
| [Qwen3.8 27B](https://broadrouter.com/ja/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | テキスト + 画像 | ツール呼び出し、構造化出力、推論（reasoning） | チャージが必要 |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ja/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | テキスト + 画像 | — | 初回クレジット |
| [BroadNet Transcribe Arabic](https://broadrouter.com/ja/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | アラビア語の音声 | — | 初回クレジット |
| [BroadNet Transcribe](https://broadrouter.com/ja/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | 音声、14 言語 | — | 初回クレジット |

「ドキュメント記載」は、BroadNet のリファレンスが各モデルについて挙げているツール呼び出し、構造化出力、推論（reasoning）です（2026-11-15 確認）。ダッシュはリファレンスに記載がないことを示し、機能がないという意味ではありません。

## 他の OpenAI 互換 API からの移行：チェックリスト

リクエストの形式は見慣れたものですが、モデルごとに違いがあります。選んだモデルについて各項目を確認し、トラフィックを切り替える前にテストしてください。

1.  **エンドポイント。** ベース URL を `https://inference.broadnet.ai/v1` に設定します。
2.  **キー。** BroadNet の推論用キーを環境変数から読み込みます。プランのキーと従量課金のキーは別です。
3.  **モデル ID。** 正確な ID を使います（例：`broadnet/gemma-4-26b-a4b`）。
4.  **パラメータ。** 送信するすべてのパラメータが、そのモデルについてドキュメントに記載されているか確認します。記載のないものは削除してください。
5.  **ストリーミング。** クライアントが SSE を `[DONE]` まで読み取り、途中で終わったストリームを処理できることを確認します。
6.  **ツール呼び出しと構造化出力。** リファレンスでは GLM 5.3、Qwen3.8 27B についてこれらが記載されています。その他のモデルは、頼る前にテストしてください。
7.  **推論（reasoning）。** 推論は出力の予算の一部を使うことがあります。`max_tokens` に余裕を持たせてください。詳しくは[推論モデルで回答が空になる問題](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)を参照してください。
8.  **上限。** 従量課金のキーは毎分 30 リクエスト、同時実行 4 です。プランのセッションは同時に 1 リクエストです。Gemma 時間制キーは 1 ストリーム、毎分 120 リクエスト、毎分 300,000 トークンです。
9.  **コンテキスト。** コンテキストには入力と回答の両方が含まれます。モデルの上限は[モデルのページ](https://broadrouter.com/ja/models/)で確認してください。
10.  **エラー。** 以下のステータスコードを再試行または修正の対応に対応づけ、`X-Request-ID` をログに残します。
11.  **コスト。** [料金計算ツール](https://broadrouter.com/ja/pricing/)で見積もります。従量課金では、画像は入力トークンとして数えます。

## 再試行すべきエラーは？

| ステータス | 意味 | 対応 |
| --- | --- | --- |
| 400 / 422 | リクエストまたはフィールドが無効 | リクエストを修正する。そのまま再試行しない |
| 401 | キーがない、無効、期限切れ、または利用枠を使い切った | キーとアカウントを確認する |
| 402 | `insufficient_balance` | チャージしてから再試行する |
| 413 | リクエストがバイト数またはテキストの上限を超えている | 送る量を減らす（例：小さい音声ファイルにする） |
| 429 | レート、同時実行、トークンレート、または支出の上限 | 上限付きでバックオフしてから再試行する |
| 500–504 | サーバー側の問題 | 上限付きの指数バックオフで再試行する |

[リファレンスのエラー表 （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-developers&utm_content=errors-docs#errors)を要約したものです（2026-11-15 確認）。[再試行のコード例](https://broadrouter.com/ja/guides/errors-and-retries/)。

## 詳しいドキュメントとガイドは？

-   [**開発者リファレンス （英語）**リクエスト形式、上限、エラー、料金フィード。正式な情報源です。](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-developers&utm_content=docs)
-   [**連携 （英語）**Aider、Cline、LangChain、n8n、LiteLLM などの OpenAI 互換ツールの設定。](https://broadrouter.com/integrations/)
-   [**ガイド**SDK、ストリーミング、再試行、IP 許可リスト、アラビア語の音声。](https://broadrouter.com/ja/guides/)
-   [**Python SDK ガイド**OpenAI Python SDK でのインストール、最初のリクエスト、ストリーミング。](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [**Node SDK ガイド**同じ内容を JavaScript と TypeScript で、リクエスト ID 付きで。](https://broadrouter.com/ja/guides/openai-node-sdk/)
-   [**cURL クイックスタート**すべてのリクエストをシェルから。](https://broadrouter.com/ja/guides/curl-quickstart/)
-   [**キーと IP 許可リスト**キーを自分のサーバーに限定します。](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/)
-   [**API リクエストビルダー （英語）**ブラウザでリクエストを組み立ててコピーできます。](https://broadrouter.com/tools/api-request-builder/)

専用エンドポイントや、一覧にないモデルが必要ですか？ [BroadNet に問い合わせる](https://broadrouter.com/ja/contact/#private)。

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

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

**出典**

-   [BroadNet Inference 開発者リファレンス（2026-11-15 確認） （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-developers&utm_content=sources)
-   [BroadNet Inference の料金 （英語）](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-developers&utm_content=sources)
-   [pricing.json（公開料金表） （英語）](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-developers&utm_content=sources)
