このページでは、キーを作ったばかりの状態から、3 つの呼び出しを動かすところまでを扱います。チャット補完、ストリーミング応答、文字起こしです。必要なのは curl だけです。BroadNet Inference は OpenAI のリクエスト形式を使っているので、ここで動けば OpenAI 互換の SDK やツールでも同じように動きます。
1. キーを設定する
BroadNet のコンソールでキーを作成します。新規アカウントには $5 の初回クレジットが付きます。
export BROADNET_API_KEY='paste-your-key'
キーは Authorization: Bearer ヘッダーでのみ送ってください。
2. 最初のチャット補完
初回クレジットで使えるチャットモデルは BroadNet Gemma 4 VL 26B だけなので、まずこれで試します。
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 に数えられます。
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 の場合は、推論の途中で上限に達しています。推論モデルが空の回答を返す理由を参照してください。
4. 応答をストリーミングする
"stream": true を加え、-N で curl のバッファリングを無効にします。
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 のストリーミングを参照してください。
5. 音声を文字起こしする
文字起こしは multipart フォームで送ります。WAV または MP3 を 26,214,400 バイトまで送れます。language は必ず指定してください。
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 のボイスメッセージを文字起こしする方法を参照してください。アラビア語では broadnet/cohere-transcribe-arabic を language=ar と組み合わせて使います。アラビア語音声認識のガイドを参照してください。料金は音声 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 分あたりの料金は料金ページにあります。モデルごとのページもあります。例:GLM 5.3。
トラブルシューティング
- 401。 キーがない、無効、期限切れ、または従量課金の利用枠を使い切っています。キーの前後に余分な空白がないか確認してください。
- model フィールドのエラー。 表から ID をコピーしてください。
broadnet/の接頭辞まで含みます。有料モデルは、チャージするまで初回クレジットでは失敗します。 - 413。 音声ファイルが 26,214,400 バイトを超えています。分割してください。
- 403。 キーの IP 許可リスト、モデル、またはルートのポリシーでリクエストが拒否されました。API キーの IP 許可リストを参照してください。
- 429。 従量課金のキーは毎分 30 リクエスト、同時実行 4 リクエストまでです。間隔を空けてリトライしてください。BroadNet のエラーコードとリトライを参照してください。
- 無制限プランの場合。 プランのセッションは 1 つにつき同時に 1 リクエストを処理するため、curl のループを並列で回すときはセッションを分けてください。プランのキーは
broadnet/deepseek-v4.1-flashでのみ使えます。
問題を報告するときは、レスポンスヘッダーの X-Request-ID を保存しておいてください(curl -D headers.txt ...)。
