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