---
title: "OpenAI Node.js SDK dengan baseURL kustom (BroadNet) | BroadRouter"
description: "Arahkan OpenAI Node.js dan TypeScript SDK resmi ke BroadNet Inference dengan mengatur baseURL. Instal, kirim permintaan pertama, stream token, dan catat request ID."
url: https://broadrouter.com/id/guides/openai-node-sdk/
lang: id
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/guides/openai-node-sdk/) (diperbarui 2026-11-16).

# Memakai OpenAI Node.js SDK dengan BroadNet Inference

Diperbarui 2026-11-16

Instal paket npm openai dan buat client dengan baseURL https://inference.broadnet.ai/v1 serta apiKey berisi kunci BroadNet Anda. Kode chat.completions yang sudah ada tetap berjalan; ubah hanya ID model, misalnya broadnet/deepseek-v4.1-flash. BroadNet melayani chat completions, bukan Responses API, jadi tetap gunakan client.chat.completions.create.

Anda memerlukan kunci inferensi dari [akun BroadNet Inference Anda](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-openai-node-sdk&utm_content=body). Akun baru dimulai dengan kredit $5 tanpa kartu. Jika Anda memakai Python, lihat [panduan Python SDK](https://broadrouter.com/id/guides/openai-python-sdk/).

## 1\. Instal dan atur kunci

Paket `openai` versi terbaru (7.x) memerlukan Node.js 22 atau lebih baru.

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

## 2\. Permintaan pertama

Simpan sebagai `first-request.mjs` lalu 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` berjalan dengan kredit gratis. Untuk model paket unlimited, gunakan `broadnet/deepseek-v4.1-flash` dan atur `max_tokens` ke 1.000 atau lebih, karena penalarannya dihitung dalam batas itu. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/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\. Catat 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 membaca `request_id` dari header `x-request-id`. Respons yang sudah di-parse juga membawanya sebagai `data._request_id`.

Simpan ID itu bersama waktu UTC, rute, dan status: tim dukungan BroadNet akan memintanya. [Kode error dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/).

## Pemecahan masalah

-   **401.** Kunci salah, kedaluwarsa, atau jatah bayar sesuai pemakaian sudah habis. Jika `BROADNET_API_KEY` tidak diatur, `apiKey` bernilai `undefined` dan SDK beralih ke `OPENAI_API_KEY`, atau melempar error jika variabel itu juga tidak ada.
-   **404.** Pastikan `baseURL` diakhiri `/v1` dan Anda memanggil `chat.completions`, bukan `responses`. Lalu periksa ID model, lengkap dengan prefiks `broadnet/`.
-   **Model berbayar gagal di akun baru.** Kredit awal $5 mencakup BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) dan dua model BroadNet Transcribe. Lakukan top up untuk memakai model chat lainnya: DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B.
-   **`content` kosong.** Penalaran dihitung dalam `max_tokens`. Naikkan nilainya atau biarkan tidak diatur. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **429.** Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan sekaligus. Secara default SDK mencoba ulang dua kali; atur `maxRetries` pada client. Untuk stream yang terputus, lihat [streaming chat completions](https://broadrouter.com/id/guides/streaming-chat-completions/).

## Istilah dalam panduan ini

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

[Streaming (respons streaming)](https://broadrouter.com/id/glossary/streaming/)

Streaming adalah cara mengembalikan respons model bahasa dalam potongan-potongan kecil selagi masih dihasilkan, bukan sebagai satu balasan utuh di akhir. API yang kompatibel dengan OpenAI melakukan streaming lewat server-sent events jika permintaan mengatur stream ke true.

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

Chat Completions API adalah endpoint HTTP milik OpenAI, POST /v1/chat/completions, yang menerima nama model dan daftar pesan bertanda peran lalu mengembalikan pesan berikutnya dari model. Bentuk request dan response-nya menjadi format umum yang dipakai ulang oleh penyedia dan SDK yang kompatibel dengan OpenAI.

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

Kredit prabayar adalah uang yang diisi ke akun API sebelum dipakai. Setiap request memotong biayanya dari saldo, dan saat saldo habis, request berbayar per pemakaian berhenti sampai Anda melakukan top up. Dengan begitu, pengeluaran dibatasi sebesar uang yang sudah Anda setor.

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

Kunci API adalah string rahasia yang mengidentifikasi dan mengotorisasi client yang memanggil API. API LLM biasanya mengharapkannya di header Authorization: Bearer, dan siapa pun yang memegang kunci itu bisa membuat permintaan yang ditagihkan ke akun pemiliknya.

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

Token adalah satuan teks yang dibaca dan ditulis model bahasa: sebuah kata, bagian kata, tanda baca, atau urutan byte yang dihasilkan tokenizer model. API LLM menghitung, membatasi, dan biasanya menagih pemakaian dalam token.

## Pertanyaan umum

### Bisakah saya mengatur base URL BroadNet lewat environment variable di Node?

Bisa. SDK membaca OPENAI\_BASE\_URL jika Anda tidak mengisi baseURL, dan OPENAI\_API\_KEY jika Anda tidak mengisi apiKey. Mengisi keduanya secara eksplisit mencegah Anda tidak sengaja mengirim kunci BroadNet ke OpenAI, atau sebaliknya.

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

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

### Versi Node.js berapa yang dibutuhkan paket openai?

Rilis 7.x saat ini mensyaratkan Node.js 22 atau lebih baru. Deno, Bun, Cloudflare Workers, dan Vercel Edge juga didukung.

### Bisakah saya memanggil BroadNet dari browser dengan Node SDK?

Jangan. SDK memblokir penggunaan di browser kecuali Anda mengatur dangerouslyAllowBrowser, karena kunci akan terkirim ke setiap pengunjung. Panggil BroadNet dari server Anda.

## Panduan terkait

-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/)
-   [Streaming chat completions dan menangani koneksi terputus](https://broadrouter.com/id/guides/streaming-chat-completions/)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

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

**Sumber**

-   [Referensi API BroadNet Inference (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-openai-node-sdk&utm_content=sources)
-   [Library Node.js OpenAI di npm (7.x, Node.js 22+, diperiksa 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README openai-node, request ID dan persyaratan (diperiksa 2026-11-14)](https://github.com/openai/openai-node)
