---
title: "OpenAI Node.js SDK với baseURL tùy chỉnh (BroadNet) | BroadRouter"
description: "Trỏ OpenAI SDK chính thức cho Node.js và TypeScript tới BroadNet Inference bằng baseURL. Cài đặt, gửi request đầu tiên, stream token và ghi log request ID."
url: https://broadrouter.com/vi/guides/openai-node-sdk/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/openai-node-sdk/) (cập nhật ngày 2026-11-16).

# Dùng OpenAI Node.js SDK với BroadNet Inference

Cập nhật 2026-11-16

Để dùng OpenAI Node.js SDK với BroadNet Inference, hãy cài gói npm openai rồi tạo client với baseURL là https://inference.broadnet.ai/v1 và apiKey là key BroadNet của bạn. Code chat.completions hiện có vẫn chạy; chỉ đổi model ID, ví dụ broadnet/deepseek-v4.1-flash. BroadNet cung cấp chat completions, không có Responses API, nên hãy tiếp tục dùng client.chat.completions.create.

Bạn cần một inference key từ [tài khoản BroadNet Inference của bạn](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-openai-node-sdk&utm_content=body). Tài khoản mới được tặng $5 tín dụng ban đầu, không cần thẻ. Nếu bạn dùng Python, hãy xem [hướng dẫn Python SDK](https://broadrouter.com/vi/guides/openai-python-sdk/).

## 1\. Cài đặt và đặt key

Gói `openai` hiện tại (7.x) cần Node.js 22 trở lên.

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

## 2\. Request đầu tiên

Lưu thành `first-request.mjs` rồi chạy `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` chạy được bằng tín dụng miễn phí. Với model của gói không giới hạn, hãy dùng `broadnet/deepseek-v4.1-flash` và đặt `max_tokens` từ 1.000 trở lên, vì phần suy luận của nó được tính vào giới hạn này. [Vì sao câu trả lời trả về trống](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).

## 3\. Stream 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\. Ghi log request 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 đọc `request_id` từ header `x-request-id`. Phản hồi đã parse cũng mang giá trị này dưới dạng `data._request_id`.

Hãy lưu ID đó cùng thời điểm theo giờ UTC, route và mã trạng thái: bộ phận hỗ trợ của BroadNet sẽ hỏi đến chúng. [Mã lỗi và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).

## Xử lý sự cố

-   **401.** Key sai, đã hết hạn hoặc đã hết hạn mức trả theo mức dùng. Nếu `BROADNET_API_KEY` chưa được đặt, `apiKey` sẽ là `undefined` và SDK chuyển sang dùng `OPENAI_API_KEY`, hoặc báo lỗi nếu biến đó cũng không có.
-   **404.** Kiểm tra rằng `baseURL` kết thúc bằng `/v1` và bạn gọi `chat.completions`, không phải `responses`. Sau đó kiểm tra model ID, có tiền tố `broadnet/`.
-   **Model trả phí báo lỗi trên tài khoản mới.** $5 tín dụng ban đầu dùng được cho BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) và hai model BroadNet Transcribe. Hãy nạp tiền để dùng các model chat khác: DeepSeek V4.1 Flash, GLM 5.3 và Qwen3.8 27B.
-   **`content` trống.** Phần suy luận được tính vào `max_tokens`. Hãy tăng giá trị này hoặc bỏ trống. [Vì sao câu trả lời trả về trống](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429.** Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request cùng lúc. Theo mặc định SDK thử lại hai lần; hãy điều chỉnh `maxRetries` trên client. Xem [streaming chat completions](https://broadrouter.com/vi/guides/streaming-chat-completions/) để xử lý luồng bị ngắt.

## Thuật ngữ trong hướng dẫn này

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[Streaming (trả phản hồi dạng luồng)](https://broadrouter.com/vi/glossary/streaming/)

Streaming là cách trả phản hồi của model ngôn ngữ thành từng chunk nhỏ ngay trong lúc nó đang được sinh, thay vì một câu trả lời trọn vẹn ở cuối. Các API tương thích OpenAI stream qua server-sent events khi request đặt stream là true.

[API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/)

API key là một chuỗi bí mật dùng để xác định và cấp quyền cho client gọi API. API LLM thường yêu cầu nó trong header Authorization: Bearer, và bất kỳ ai giữ key đều có thể gửi request được tính phí vào tài khoản sở hữu key đó.

[Chat Completions API](https://broadrouter.com/vi/glossary/chat-completions-api/)

Chat Completions API là endpoint HTTP của OpenAI, POST /v1/chat/completions, nhận tên model và danh sách message có gắn vai trò rồi trả về message tiếp theo của model. Cấu trúc request và response của nó đã trở thành định dạng chung mà các nhà cung cấp và SDK tương thích OpenAI dùng lại.

[Concurrency (request đồng thời)](https://broadrouter.com/vi/glossary/concurrency/)

Concurrency (request đồng thời) là số request mà một client đang xử lý cùng lúc. Các API LLM thường giới hạn nó theo key hoặc theo gói, tách biệt với số request mỗi phút, vì mỗi request đang mở chiếm dụng năng lực GPU cho tới khi response kết thúc.

[Gói LLM giá cố định (flat-rate LLM plan)](https://broadrouter.com/vi/glossary/flat-rate-llm-plan/)

Gói LLM giá cố định tính một mức giá cố định cho mỗi kỳ, ví dụ một tháng, để dùng API mô hình ngôn ngữ thay vì tính theo token. Gói này thường giới hạn thứ khác, như số request đồng thời, tốc độ, model hay khung giờ sử dụng, nên giới hạn quan trọng không kém giá.

[Token](https://broadrouter.com/vi/glossary/token/)

Token là đơn vị văn bản mà model ngôn ngữ đọc và viết: một từ, một phần của từ, một dấu câu hoặc một chuỗi byte do tokenizer của model tạo ra. API LLM đếm, giới hạn và thường tính phí theo token.

## Câu hỏi thường gặp

### Trong Node, có đặt base URL của BroadNet bằng biến môi trường được không?

Được. SDK đọc OPENAI\_BASE\_URL khi bạn không truyền baseURL, và đọc OPENAI\_API\_KEY khi bạn không truyền apiKey. Truyền rõ cả hai giúp tránh vô tình gửi key BroadNet sang OpenAI, hoặc ngược lại.

### client.responses.create có chạy với BroadNet không?

Không. Tài liệu của BroadNet chỉ liệt kê chat completions và audio transcriptions. Với chat, hãy dùng client.chat.completions.create.

### Gói openai cần Node.js phiên bản nào?

Bản phát hành 7.x hiện tại yêu cầu Node.js 22 trở lên. Deno, Bun, Cloudflare Workers và Vercel Edge cũng được hỗ trợ.

### Có gọi BroadNet từ trình duyệt bằng Node SDK được không?

Đừng làm vậy. SDK chặn việc dùng trong trình duyệt trừ khi bạn đặt dangerouslyAllowBrowser, vì key sẽ bị gửi tới mọi người truy cập. Hãy gọi BroadNet từ server của bạn.

## Hướng dẫn liên quan

-   [Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/)
-   [Streaming chat completions và xử lý khi mất kết nối](https://broadrouter.com/vi/guides/streaming-chat-completions/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-openai-node-sdk&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu tham chiếu API BroadNet Inference (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-openai-node-sdk&utm_content=sources)
-   [Thư viện OpenAI Node.js trên npm (7.x, Node.js 22 trở lên, kiểm tra ngày 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README của openai-node: request ID và yêu cầu hệ thống (kiểm tra ngày 2026-11-14)](https://github.com/openai/openai-node)
