---
title: "curl 调用大模型 API 快速入门：对话、流式输出与语音转写 | BroadRouter"
description: "用 curl 完成对 BroadNet Inference 的首次调用：一次对话补全、一次流式输出和一次音频转写，并学会读懂响应、usage 和错误。"
url: https://broadrouter.com/zh/guides/curl-quickstart/
lang: zh-Hans
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 API

更新于 2026-11-16

向 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](https://broadrouter.com/zh/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` 里是你要付费的 token 数。

## 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/zh/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（SSE）。流以字面上的 `data: [DONE]` 这一行结束；开启 `include_usage` 后，最后一个数据块会带上 token 数。详见[流式对话补全](https://broadrouter.com/zh/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/zh/guides/transcribe-whatsapp-voice-notes/)。阿拉伯语请使用 `broadnet/cohere-transcribe-arabic` 并设置 `language=ar`，参见[阿拉伯语语音转文字指南](https://broadrouter.com/zh/guides/arabic-speech-to-text-api/)。多语言模型每音频分钟 $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 和按分钟的价格见[价格页面](https://broadrouter.com/zh/pricing/)。每个模型都有自己的页面，例如 [GLM 5.3](https://broadrouter.com/zh/models/glm-5.3/)。

## 故障排查

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

报告问题时，请保存响应头 `X-Request-ID`（`curl -D headers.txt ...`）。

## 本指南涉及的术语

[Token（词元）](https://broadrouter.com/zh/glossary/token/)

token（词元）是大语言模型读写文本的基本单位：由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制，通常也按 token 计费。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[IP 白名单（IP allow list）](https://broadrouter.com/zh/glossary/ip-allow-list/)

IP 白名单是一种安全控制：只接受来自列出的 IP 地址或 CIDR 网段的请求，拒绝其他所有请求。用在 API 上，它能限制密钥泄露造成的损失，因为密钥在不在列表中的网络上无法使用。

[SSE（服务器发送事件，Server-sent events）](https://broadrouter.com/zh/glossary/sse/)

SSE（服务器发送事件，Server-sent events）是一项 Web 标准，让服务器通过一个内容类型为 text/event-stream 的长连接 HTTP 响应，向客户端推送一连串文本事件。每个事件由一行或多行字段（如 data:）组成，以一个空行结束。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[大模型包月套餐（flat-rate LLM plan）](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)

大模型包月套餐（固定价格套餐）是按一个周期（如一个月）收取固定费用、提供大模型 API 使用权的计价方式，不按 token 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/)

速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限，例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝，通常返回 HTTP 429 Too Many Requests，直到用量回落到限制以下。

[Chat Completions API（对话补全接口）](https://broadrouter.com/zh/glossary/chat-completions-api/)

Chat Completions API 是 OpenAI 的 HTTP 端点 POST /v1/chat/completions，它接收模型名称和一组带角色标记的消息，返回模型的下一条消息。它的请求与响应结构已成为 OpenAI 兼容服务商和各类 SDK 通用的格式。

## 常见问题

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

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。

## 相关指南

-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/)
-   [对话补全的流式输出，以及连接中断的处理](https://broadrouter.com/zh/guides/streaming-chat-completions/)
-   [阿拉伯语语音转文字 API 分步教程](https://broadrouter.com/zh/guides/arabic-speech-to-text-api/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)

用你的真实业务负载试一试。 新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-curl-quickstart&utm_content=page-cta) ·

**来源**

-   [BroadNet Inference API 参考文档 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-curl-quickstart&utm_content=sources)
-   [机器可读的模型列表与价格（pricing.json） （英文）](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-curl-quickstart&utm_content=sources)
