---
title: "OpenAI Node.js SDK dengan baseURL tersuai (BroadNet)"
description: "Halakan OpenAI Node.js dan TypeScript SDK rasmi ke BroadNet Inference dengan menetapkan baseURL. Pasang, buat permintaan pertama, strim token dan log ID permintaan."
url: https://broadrouter.com/ms/guides/openai-node-sdk/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/openai-node-sdk/) (dikemas kini 2026-11-16).

# Cara guna OpenAI Node.js SDK dengan BroadNet Inference

Dikemas kini 2026-11-16

Pasang pakej npm openai dan cipta klien dengan baseURL ditetapkan kepada https://inference.broadnet.ai/v1 dan apiKey kepada kunci BroadNet anda. Kod chat.completions sedia ada terus berfungsi; tukar ID model sahaja, contohnya broadnet/deepseek-v4.1-flash. BroadNet menyediakan chat completions, bukan Responses API, jadi teruskan menggunakan client.chat.completions.create.

Anda memerlukan kunci inferens daripada [akaun BroadNet Inference anda](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-openai-node-sdk&utm_content=body). Akaun baharu bermula dengan kredit $5 tanpa kad. Jika anda menggunakan Python, lihat [panduan Python SDK](https://broadrouter.com/ms/guides/openai-python-sdk/).

## 1\. Pasang dan tetapkan kunci

Pakej `openai` semasa (7.x) memerlukan Node.js 22 atau lebih baharu.

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

## 2\. Permintaan pertama

Simpan sebagai `first-request.mjs` dan jalankan `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` berfungsi pada kredit percuma. Untuk model pelan tanpa had, gunakan `broadnet/deepseek-v4.1-flash` dan tetapkan `max_tokens` kepada 1,000 atau lebih, kerana penaakulannya dikira dalam had itu. [Mengapa jawapan kembali kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).

## 3\. Strim 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\. Log ID permintaan

```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 membaca `request_id` daripada pengepala `x-request-id`. Respons yang telah dihurai juga membawanya sebagai `data._request_id`.

Simpan ID itu bersama masa UTC, laluan dan status: sokongan BroadNet akan memintanya. [Kod ralat dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## Penyelesaian masalah

-   **401.** Kunci salah, tamat tempoh, atau elaun bayar ikut guna telah habis. Jika `BROADNET_API_KEY` tidak ditetapkan, `apiKey` menjadi `undefined` dan SDK beralih kepada `OPENAI_API_KEY`, atau membaling ralat jika itu juga tiada.
-   **404.** Pastikan `baseURL` berakhir dengan `/v1` dan anda memanggil `chat.completions`, bukan `responses`. Kemudian semak ID model, termasuk awalan `broadnet/`.
-   **Model berbayar gagal pada akaun baharu.** Kredit permulaan $5 meliputi BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) dan dua model BroadNet Transcribe. Buat tambah nilai untuk menggunakan model chat lain: DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B.
-   **`content` kosong.** Penaakulan dikira dalam `max_tokens`. Naikkan nilainya atau biarkan tidak ditetapkan. [Mengapa jawapan kembali kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Secara lalai, SDK mencuba semula dua kali; laraskan `maxRetries` pada klien. Lihat [penstriman chat completions](https://broadrouter.com/ms/guides/streaming-chat-completions/) untuk strim yang terputus.

## Istilah dalam panduan ini

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

[Penstriman (streaming)](https://broadrouter.com/ms/glossary/streaming/)

Penstriman ialah cara memulangkan respons model bahasa dalam cebisan kecil semasa ia masih dijana, dan bukan sebagai satu jawapan di penghujung. API serasi OpenAI menstrim melalui server-sent events apabila permintaan menetapkan stream kepada true.

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

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

[Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/)

Had kadar ialah had yang ditetapkan oleh API ke atas jumlah penggunaan klien dalam satu tempoh masa, seperti permintaan seminit atau token seminit. Permintaan yang melebihi had ditolak, biasanya dengan HTTP 429 Too Many Requests, sehingga penggunaan turun semula di bawahnya.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/)

Kredit prabayar ialah wang yang ditambah ke akaun API sebelum digunakan. Setiap permintaan menolak kosnya daripada baki, dan apabila baki habis, permintaan bermeter berhenti sehingga anda menambah nilai. Ia mengehadkan perbelanjaan kepada jumlah yang telah anda bayar.

[Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/)

Kunci API ialah rentetan rahsia yang mengenal pasti dan membenarkan klien yang memanggil sesuatu API. API LLM biasanya menjangkakannya dalam pengepala Authorization: Bearer, dan sesiapa yang memegang kunci itu boleh membuat permintaan yang dibilkan kepada akaun pemiliknya.

[Pelan LLM harga tetap (flat-rate LLM plan)](https://broadrouter.com/ms/glossary/flat-rate-llm-plan/)

Pelan LLM harga tetap mengenakan harga tetap bagi satu tempoh, seperti sebulan, untuk akses kepada API model bahasa dan bukannya mengebil setiap token. Pelan sebegini biasanya mengehadkan perkara lain, seperti keserentakan, kelajuan, model atau tetingkap penggunaan, jadi hadnya sama penting dengan harganya.

## Soalan lazim

### Bolehkah saya menetapkan base URL BroadNet dengan pembolehubah persekitaran dalam Node?

Ya. SDK membaca OPENAI\_BASE\_URL apabila anda tidak menghantar baseURL, dan OPENAI\_API\_KEY apabila anda tidak menghantar apiKey. Menghantar kedua-duanya secara eksplisit mengelakkan anda tersilap menghantar kunci BroadNet kepada OpenAI, atau sebaliknya.

### Adakah client.responses.create berfungsi dengan BroadNet?

Tidak. Dokumentasi BroadNet hanya menyenaraikan chat completions dan audio transcriptions. Gunakan client.chat.completions.create untuk chat.

### Versi Node.js manakah yang diperlukan oleh pakej openai?

Keluaran 7.x semasa menetapkan Node.js 22 atau lebih baharu. Deno, Bun, Cloudflare Workers dan Vercel Edge juga disokong.

### Bolehkah saya memanggil BroadNet dari pelayar dengan Node SDK?

Jangan. SDK menyekat penggunaan dalam pelayar kecuali anda menetapkan dangerouslyAllowBrowser, kerana kunci akan dihantar kepada setiap pelawat. Panggil BroadNet dari pelayan anda.

## Panduan berkaitan

-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/)
-   [Strim chat completions dan kendalikan sambungan yang terputus](https://broadrouter.com/ms/guides/streaming-chat-completions/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-openai-node-sdk&utm_content=page-cta) ·

**Sumber**

-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-openai-node-sdk&utm_content=sources)
-   [Pustaka OpenAI Node.js di npm (7.x, Node.js 22+, disemak 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README openai-node, ID permintaan dan keperluan (disemak 2026-11-14)](https://github.com/openai/openai-node)
