---
title: "curl で LLM API 入門：チャット、ストリーミング、文字起こし | BroadRouter"
description: "curl で BroadNet Inference を初めて呼び出す手順です。チャット補完、ストリーミング応答、音声の文字起こしを試し、レスポンス、usage、エラーの読み方を確認します。"
url: https://broadrouter.com/ja/guides/curl-quickstart/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# curl で BroadNet Inference に最初のリクエストを送る

更新日 2026-11-16

https://inference.broadnet.ai/v1/chat/completions に POST し、Authorization: Bearer ヘッダーにキーを入れ、JSON ボディに model（例：broadnet/gemma-4-26b-a4b）と messages を指定します。ストリーミングは stream を true にします。音声は model、language、file を multipart フォームで /v1/audio/transcriptions に送ります。

このページでは、キーを作ったばかりの状態から、3 つの呼び出しを動かすところまでを扱います。チャット補完、ストリーミング応答、文字起こしです。必要なのは curl だけです。BroadNet Inference は OpenAI のリクエスト形式を使っているので、ここで動けば [OpenAI 互換の SDK](https://broadrouter.com/ja/guides/openai-python-sdk/) やツールでも同じように動きます。

## 1\. キーを設定する

BroadNet のコンソールでキーを作成します。新規アカウントには $5 の初回クレジットが付きます。

```bash
export BROADNET_API_KEY='paste-your-key'
```

キーは `Authorization: Bearer` ヘッダーでのみ送ってください。

## 2\. 最初のチャット補完

初回クレジットで使えるチャットモデルは BroadNet Gemma 4 VL 26B だけなので、まずこれで試します。

```bash
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": "Say hello in English and Arabic."}]
  }'
```

返ってくるのは標準的な chat completions の JSON です。回答は `choices[0].message.content` に入り、課金対象のトークン数は `usage` に入っています。

## 3\. 推論モデルを試す

チャージしたら、モデルを切り替えます。GLM 5.3、Qwen3.8 27B、DeepSeek V4.1 Flash は回答の前に推論し、その推論も `max_tokens` に数えられます。

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/glm-5.3",
    "max_tokens": 2000,
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
  }'
```

`content` が空で `finish_reason` が `length` の場合は、推論の途中で上限に達しています。[推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)を参照してください。

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

`"stream": true` を加え、`-N` で curl のバッファリングを無効にします。

```bash
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 to five."}]}'
```

Server-Sent Events で届きます。ストリームは `data: [DONE]` という行そのもので終わり、`include_usage` を付けると最後のチャンクにトークン数が入ります。詳しくは [chat completions のストリーミング](https://broadrouter.com/ja/guides/streaming-chat-completions/)を参照してください。

## 5\. 音声を文字起こしする

文字起こしは multipart フォームで送ります。WAV または MP3 を 26,214,400 バイトまで送れます。`language` は必ず指定してください。

```bash
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe \
  -F language=en \
  -F file=@meeting.mp3
```

レスポンスは JSON で、文字起こしは `text` に入っています。WhatsApp の `.ogg` ボイスメッセージや `.m4a` の録音は、先に変換が必要です。[WhatsApp のボイスメッセージを文字起こしする方法](https://broadrouter.com/ja/guides/transcribe-whatsapp-voice-notes/)を参照してください。アラビア語では `broadnet/cohere-transcribe-arabic` を `language=ar` と組み合わせて使います。[アラビア語音声認識のガイド](https://broadrouter.com/ja/guides/arabic-speech-to-text-api/)を参照してください。料金は音声 1 分あたり、多言語モデルが $0.002、アラビア語モデルが $0.0042 です。

## どのモデルを選ぶか

| モデル | ID | エンドポイント | 無料クレジット |
| --- | --- | --- | --- |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | `/v1/chat/completions` | 使える |
| GLM 5.3 | `broadnet/glm-5.3` | `/v1/chat/completions` | 使えない |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | `/v1/chat/completions` | 使えない |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | `/v1/chat/completions` | 使えない |
| BroadNet Transcribe | `broadnet/cohere-transcribe` | `/v1/audio/transcriptions` | 使える |
| BroadNet Transcribe Arabic | `broadnet/cohere-transcribe-arabic` | `/v1/audio/transcriptions` | 使える |

トークン単価と 1 分あたりの料金は[料金ページ](https://broadrouter.com/ja/pricing/)にあります。モデルごとのページもあります。例：[GLM 5.3](https://broadrouter.com/ja/models/glm-5.3/)。

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

-   **401。** キーがない、無効、期限切れ、または従量課金の利用枠を使い切っています。キーの前後に余分な空白がないか確認してください。
-   **model フィールドのエラー。** 表から ID をコピーしてください。`broadnet/` の接頭辞まで含みます。有料モデルは、チャージするまで初回クレジットでは失敗します。
-   **413。** 音声ファイルが 26,214,400 バイトを超えています。分割してください。
-   **403。** キーの IP 許可リスト、モデル、またはルートのポリシーでリクエストが拒否されました。[API キーの IP 許可リスト](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/)を参照してください。
-   **429。** 従量課金のキーは毎分 30 リクエスト、同時実行 4 リクエストまでです。間隔を空けてリトライしてください。[BroadNet のエラーコードとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。
-   **無制限プランの場合。** [プランのセッション](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)は 1 つにつき同時に 1 リクエストを処理するため、curl のループを並列で回すときはセッションを分けてください。プランのキーは `broadnet/deepseek-v4.1-flash` でのみ使えます。

問題を報告するときは、レスポンスヘッダーの `X-Request-ID` を保存しておいてください（`curl -D headers.txt ...`）。

## このガイドの用語

[トークン（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 が使う共通形式になりました。

[IP 許可リスト（IP allow list）](https://broadrouter.com/ja/glossary/ip-allow-list/)

IP 許可リストとは、登録した IP アドレスや CIDR 範囲からのリクエストだけを受け付け、それ以外をすべて拒否するセキュリティ対策です。API に使うと、リストにないネットワークからはキーが使えないため、キー漏えいの被害を抑えられます。

[SSE（Server-Sent Events）](https://broadrouter.com/ja/glossary/sse/)

SSE（Server-Sent Events）とは、content type が text/event-stream の長時間続く 1 つの HTTP 応答を通じて、サーバーがクライアントにテキストイベントのストリームを送るための Web 標準です。各イベントは data: などのフィールド行 1 行以上と、最後の空行からなります。

[プリペイドクレジット（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 はこの方式で、前払いの残高か定期的な請求書から支払います。

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

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

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

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

## よくある質問

### 無料の初回クレジットで呼び出せるモデルはどれですか？

BroadNet Gemma 4 VL 26B（モデル ID は broadnet/gemma-4-26b-a4b）と、2 つの文字起こしモデルです。GLM 5.3、Qwen3.8 27B、DeepSeek V4.1 Flash はチャージが必要です。

### curl のレスポンスで message の content が空なのはなぜですか？

推論（reasoning）モデルは、まず max\_tokens を推論に使います。finish\_reason が length なら、max\_tokens を 1,000 以上に上げてください。

### アラビア語の文字起こしがラテン文字で返ってくるのはなぜですか？

リクエストに language フィールドがなかったためです。アラビア語では language=ar を、ほかの言語では対応する ISO 639-1 コードを送ってください。

### GET /v1/models には呼び出せるモデルがすべて載っていますか？

BroadNet のドキュメントには、GET /v1/models は "supplies public catalogue metadata for external monitors"（訳：外部の監視ツール向けに公開カタログのメタデータを提供する）とあります。リクエストには API リファレンスか pricing.json に載っているモデル ID を使ってください。

## 関連ガイド

-   [OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [chat completions のストリーミングと接続切断への対処](https://broadrouter.com/ja/guides/streaming-chat-completions/)
-   [アラビア語の音声認識 API を使う手順](https://broadrouter.com/ja/guides/arabic-speech-to-text-api/)
-   [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-curl-quickstart&utm_content=page-cta) ·

**出典**

-   [BroadNet Inference API リファレンス （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-curl-quickstart&utm_content=sources)
-   [機械可読なモデル一覧と料金（pricing.json） （英語）](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-curl-quickstart&utm_content=sources)
