BroadRouter
始める

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

更新日

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 やツールでも同じように動きます。

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 ...)。

よくある質問

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

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 を使ってください。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く