BroadRouter
开始使用

用 curl 首次调用 BroadNet Inference API

更新于

向 https://inference.broadnet.ai/v1/chat/completions 发送 POST 请求,带上 Authorization: Bearer 和你的密钥,JSON 请求体里写 model(例如 broadnet/gemma-4-26b-a4b)和 messages。加上 stream true 即为流式输出。音频则以 multipart 表单把 model、language 和 file 发到 /v1/audio/transcriptions。

这一页带你从一个新密钥走到三个能跑通的调用:一次对话补全、一次流式输出和一次转写。你只需要 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 里是你要付费的 token 数。

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(SSE)。流以字面上的 data: [DONE] 这一行结束;开启 include_usage 后,最后一个数据块会带上 token 数。详见流式对话补全。

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,参见阿拉伯语语音转文字指南。多语言模型每音频分钟 $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 是

按 token 和按分钟的价格见价格页面。每个模型都有自己的页面,例如 GLM 5.3。

故障排查

  • 401。 密钥缺失、无效或已过期,或者按量付费额度已用完。检查密钥前后有没有多余的空格。
  • model 字段报错。 从上表复制 ID,它包含 broadnet/ 前缀。付费模型在充值之前用初始额度调用会失败。
  • 413。 音频文件超过 26,214,400 字节。请先切分。
  • 403。 请求被密钥的 IP 白名单、模型策略或路由策略拒绝。参见API 密钥的 IP 白名单。
  • 429。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个进行中的请求。请退避后重试。参见BroadNet 错误码与重试。
  • 使用不限量套餐时。 每个套餐会话同一时间只处理一个请求,所以并行的 curl 循环要分别跑在不同的会话上。套餐密钥只能用于 broadnet/deepseek-v4.1-flash。

报告问题时,请保存响应头 X-Request-ID(curl -D headers.txt ...)。

常见问题

用免费的初始额度能调用哪个模型?

BroadNet Gemma 4 VL 26B(模型 ID broadnet/gemma-4-26b-a4b),以及两个转写模型。GLM 5.3、Qwen3.8 27B 和 DeepSeek V4.1 Flash 需要先充值。

为什么 curl 返回的 message content 是空的?

思考模型会先把 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