---
title: "OpenAI Node.js SDK 配置自定义 baseURL（BroadNet） | BroadRouter"
description: "设置 baseURL，让官方 OpenAI Node.js / TypeScript SDK 调用 BroadNet Inference：安装、发出第一个请求、流式输出 token，并记录请求 ID。"
url: https://broadrouter.com/zh/guides/openai-node-sdk/
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/openai-node-sdk/) (2026-11-16 更新).

# 用 OpenAI Node.js SDK 调用 BroadNet Inference

更新于 2026-11-16

安装 npm 上的 openai 包，创建客户端时把 baseURL 设为 https://inference.broadnet.ai/v1，apiKey 填你的 BroadNet 密钥。现有的 chat.completions 代码照常可用，只需换模型 ID，例如 broadnet/deepseek-v4.1-flash。BroadNet 提供对话补全，不提供 Responses API，所以请继续使用 client.chat.completions.create。

你需要一个来自 [BroadNet Inference 账户](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-openai-node-sdk&utm_content=body)的推理密钥。新账户自带 $5 额度，无需绑卡。如果你用的是 Python，请看 [Python SDK 指南](https://broadrouter.com/zh/guides/openai-python-sdk/)。

## 1\. 安装并设置密钥

当前的 `openai` 包（7.x）需要 Node.js 22 或更高版本。

```bash
npm install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. 第一个请求

保存为 `first-request.mjs`，然后运行 `node first-request.mjs`：

```js
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

const response = await client.chat.completions.create({
  model: "broadnet/gemma-4-26b-a4b",
  messages: [{ role: "user", content: "Reply with one short sentence." }],
});
console.log(response.choices[0].message.content);
```

`broadnet/gemma-4-26b-a4b` 可以用免费额度运行。不限量套餐的模型请使用 `broadnet/deepseek-v4.1-flash`，并把 `max_tokens` 设为 1,000 或更多，因为它的思考内容计入这个上限。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。

## 3\. 流式输出 token

```js
const stream = await client.chat.completions.create({
  model: "broadnet/deepseek-v4.1-flash",
  stream: true,
  stream_options: { include_usage: true },
  messages: [{ role: "user", content: "Count from one to three." }],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
  if (chunk.usage) console.log("\n", chunk.usage);
}
```

## 4\. 记录请求 ID

```js
const { data, request_id } = await client.chat.completions
  .create({ model: "broadnet/gemma-4-26b-a4b", messages: [{ role: "user", content: "Hi" }] })
  .withResponse();
console.log(request_id, data.choices[0].message.content);
```

SDK 从 `x-request-id` 响应头读取 `request_id`。解析后的响应对象也会以 `data._request_id` 提供它。

请把这个 ID 和 UTC 时间、路由、状态码一起保存：BroadNet 的技术支持会要这些信息。[错误码与何时重试](https://broadrouter.com/zh/guides/errors-and-retries/)。

## 故障排查

-   **401。** 密钥错误、已过期，或者按量付费额度已用完。如果没有设置 `BROADNET_API_KEY`，`apiKey` 就是 `undefined`，SDK 会退回使用 `OPENAI_API_KEY`；如果那个也没有，就会抛出错误。
-   **404。** 确认 `baseURL` 以 `/v1` 结尾，并且调用的是 `chat.completions` 而不是 `responses`。然后检查模型 ID 是否带 `broadnet/` 前缀。
-   **新账户调用付费模型失败。** $5 初始额度可用于 BroadNet Gemma 4 VL 26B（`broadnet/gemma-4-26b-a4b`）和两个 BroadNet Transcribe 模型。其他对话模型（DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B）需要充值后才能使用。
-   **`content` 为空。** 思考内容计入 `max_tokens`。把它调高，或者干脆不设置。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个。SDK 默认会重试两次；可以在客户端上调整 `maxRetries`。流中断的处理见[流式对话补全](https://broadrouter.com/zh/guides/streaming-chat-completions/)。

## 本指南涉及的术语

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

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

[并发（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 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[输入 token 与输出 token](https://broadrouter.com/zh/glossary/input-and-output-tokens/)

输入 token 是语言模型在一次请求中读取的 token，包括系统提示词、对话历史、工具定义和图片。输出 token 是模型生成回复的 token，包括思考内容。大模型 API 通常分别计价，输出一般更贵。

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

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

[API 密钥（API key）](https://broadrouter.com/zh/glossary/api-key/)

API 密钥是一串用于识别和授权 API 调用方的秘密字符串。大模型 API 通常要求把它放在 Authorization: Bearer 请求头里，任何持有该密钥的人都能发起请求，费用记在拥有该密钥的账户上。

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

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

## 常见问题

### 在 Node 里可以用环境变量设置 BroadNet 的 base URL 吗？

可以。没有传 baseURL 时 SDK 会读取 OPENAI\_BASE\_URL，没有传 apiKey 时会读取 OPENAI\_API\_KEY。两个都显式传入，可以避免不小心把 BroadNet 密钥发给 OpenAI，或者反过来。

### client.responses.create 能在 BroadNet 上用吗？

不能。BroadNet 的文档只列出了对话补全和音频转写。对话请使用 client.chat.completions.create。

### openai 包需要哪个版本的 Node.js？

当前的 7.x 版本要求 Node.js 22 或更高版本。也支持 Deno、Bun、Cloudflare Workers 和 Vercel Edge。

### 可以在浏览器里用 Node SDK 调用 BroadNet 吗？

不要这样做。除非设置 dangerouslyAllowBrowser，否则 SDK 会阻止在浏览器中使用，因为密钥会被下发给每一个访问者。请改为从你的服务器调用 BroadNet。

## 相关指南

-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/)
-   [对话补全的流式输出，以及连接中断的处理](https://broadrouter.com/zh/guides/streaming-chat-completions/)
-   [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-openai-node-sdk&utm_content=page-cta) ·

**来源**

-   [BroadNet Inference API 参考文档 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-openai-node-sdk&utm_content=sources)
-   [npm 上的 OpenAI Node.js 库（7.x，Node.js 22+，核对于 2026-11-14）](https://www.npmjs.com/package/openai)
-   [openai-node README：请求 ID 与环境要求（核对于 2026-11-14）](https://github.com/openai/openai-node)
