---
title: "OpenAI Node.js SDK na may custom baseURL (BroadNet) | BroadRouter"
description: "Ituro ang opisyal na OpenAI Node.js at TypeScript SDK sa BroadNet Inference gamit ang baseURL. I-install, magpadala ng request, mag-stream at i-log ang request ID."
url: https://broadrouter.com/fil/guides/openai-node-sdk/
lang: fil
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Isinalin mula sa Ingles sa tulong ng AI. [Basahin ang orihinal sa Ingles](https://broadrouter.com/guides/openai-node-sdk/) (na-update noong 2026-11-16).

# Paano gamitin ang OpenAI Node.js SDK sa BroadNet Inference

Na-update 2026-11-16

I-install ang openai npm package at gawin ang client na may baseURL na https://inference.broadnet.ai/v1 at apiKey na ang BroadNet key mo. Gagana pa rin ang kasalukuyan mong chat.completions code; ang model ID lang ang palitan, halimbawa broadnet/deepseek-v4.1-flash. Chat completions ang sinusuportahan ng BroadNet, hindi ang Responses API, kaya gamitin pa rin ang client.chat.completions.create.

Kailangan mo ng inference key mula sa [BroadNet Inference account mo](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-openai-node-sdk&utm_content=body). Nagsisimula ang mga bagong account sa $5 na credit, walang card na kailangan. Kung Python ang gamit mo, tingnan ang [gabay sa Python SDK](https://broadrouter.com/fil/guides/openai-python-sdk/).

## 1\. Mag-install at i-set ang key

Kailangan ng kasalukuyang `openai` package (7.x) ang Node.js 22 o mas bago.

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

## 2\. Unang request

I-save bilang `first-request.mjs` at patakbuhin ang `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);
```

Gumagana ang `broadnet/gemma-4-26b-a4b` sa libreng credit. Para sa model ng unlimited plan, gamitin ang `broadnet/deepseek-v4.1-flash` at i-set ang `max_tokens` sa 1,000 o higit pa, dahil kasama ang reasoning nito sa limit. [Bakit walang laman ang mga sagot](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).

## 3\. Mag-stream ng mga 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\. I-log ang 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);
```

Binabasa ng SDK ang `request_id` mula sa `x-request-id` header. Nasa `data._request_id` din ito sa mga parsed na response.

Itago ang ID na iyon kasama ng oras sa UTC, ng route at ng status: hinihingi ang mga ito ng support ng BroadNet. [Mga error code at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/).

## Troubleshooting

-   **401.** Mali o expired ang key, o ubos na ang pay-as-you-go allowance. Kapag hindi naka-set ang `BROADNET_API_KEY`, `undefined` ang `apiKey` at babalik ang SDK sa `OPENAI_API_KEY`, o magta-throw ito kung wala rin iyon.
-   **404.** Tiyaking nagtatapos sa `/v1` ang `baseURL` at `chat.completions` ang tinatawag mo, hindi `responses`. Pagkatapos, suriin ang model ID, kasama ang `broadnet/` prefix.
-   **Pumapalya ang bayad na model sa bagong account.** Sakop ng $5 na panimulang credit ang BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) at ang dalawang BroadNet Transcribe model. Mag-top up para magamit ang ibang chat model: DeepSeek V4.1 Flash, GLM 5.3 at Qwen3.8 27B.
-   **Walang laman ang `content`.** Kasama ang reasoning sa `max_tokens`. Taasan ito o huwag i-set. [Bakit walang laman ang mga sagot](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).
-   **429.** Ang isang pay-as-you-go key ay may 30 request kada minuto at 4 na sabay-sabay. Dalawang beses nagre-retry ang SDK bilang default; i-adjust ang `maxRetries` sa client. Tingnan ang [streaming chat completions](https://broadrouter.com/fil/guides/streaming-chat-completions/) para sa mga naputol na stream.

## Mga termino sa gabay na ito

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

Ang API key ay isang lihim na string na kumikilala at nagpapahintulot sa client na tumatawag sa isang API. Kadalasang hinihingi ito ng mga LLM API sa Authorization: Bearer header, at ang sinumang may hawak ng key ay makakagawa ng mga request na sisingilin sa account na may-ari nito.

[Pay-as-you-go](https://broadrouter.com/fil/glossary/pay-as-you-go/)

Ang pay-as-you-go ay paraan ng pagpepresyo kung saan ang nagamit mo lang ang binabayaran mo, sinusukat kada yunit gaya ng token, request o minuto ng audio, nang walang subscription o minimum na commitment. Ganito naniningil ang karamihan ng LLM API, mula sa prepaid na balance o sa pana-panahong invoice.

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

Ang token ay ang yunit ng text na binabasa at isinusulat ng isang language model: isang salita, bahagi ng salita, bantas o byte sequence na ginawa ng tokenizer ng model. Sa token binibilang, nililimitahan at kadalasang sinisingil ng mga LLM API ang paggamit.

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

Ang Chat Completions API ay HTTP endpoint ng OpenAI, POST /v1/chat/completions, na tumatanggap ng pangalan ng model at listahan ng mga message na may role, at ibinabalik ang susunod na message ng model. Ang hugis ng request at response nito ang naging karaniwang format na ginagamit din ng mga OpenAI-compatible na provider at SDK.

[Concurrency](https://broadrouter.com/fil/glossary/concurrency/)

Ang concurrency ay ang bilang ng request na sabay-sabay na in flight mula sa isang client. Madalas itong nililimitahan ng mga LLM API kada key o plan, hiwalay sa requests per minute, dahil humahawak ng GPU capacity ang bawat bukas na request hanggang matapos ang response nito.

[Rate limit](https://broadrouter.com/fil/glossary/rate-limit/)

Ang rate limit ay hangganang itinatakda ng API sa dami ng paggamit ng isang client sa isang yugto ng oras, gaya ng request kada minuto o token kada minuto. Tinatanggihan ang mga request na lampas sa limit, kadalasan na may HTTP 429 Too Many Requests, hanggang bumaba ulit ang paggamit.

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

Ang streaming ay paraan ng pagbabalik ng sagot ng language model nang paunti-unting chunk habang binubuo pa ito, sa halip na iisang sagot sa dulo. Sa mga OpenAI-compatible na API, dumadaan ang streaming sa server-sent events kapag naka-set sa true ang stream sa request.

## Mga tanong

### Puwede ko bang i-set ang base URL ng BroadNet gamit ang environment variable sa Node?

Oo. Binabasa ng SDK ang OPENAI\_BASE\_URL kapag hindi mo ipinasa ang baseURL, at ang OPENAI\_API\_KEY kapag hindi mo ipinasa ang apiKey. Kapag tahasan mong ipinasa ang dalawa, hindi mo aksidenteng maipapadala ang BroadNet key sa OpenAI, o ang kabaligtaran.

### Gumagana ba ang client.responses.create sa BroadNet?

Hindi. Chat completions at audio transcriptions lang ang nakalista sa docs ng BroadNet. Gamitin ang client.chat.completions.create para sa chat.

### Anong Node.js version ang kailangan ng openai package?

Node.js 22 o mas bago ang nakadeklara sa kasalukuyang 7.x release. Suportado rin ang Deno, Bun, Cloudflare Workers at Vercel Edge.

### Puwede ko bang tawagin ang BroadNet mula sa browser gamit ang Node SDK?

Huwag. Bina-block ng SDK ang paggamit sa browser maliban kung i-set mo ang dangerouslyAllowBrowser, dahil maipapadala ang key sa bawat bisita. Tawagin ang BroadNet mula sa server mo.

## Mga kaugnay na gabay

-   [Paano gamitin ang OpenAI Python SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/openai-python-sdk/)
-   [Paano mag-stream ng chat completions at ayusin ang naputol na stream](https://broadrouter.com/fil/guides/streaming-chat-completions/)
-   [Mga error code ng BroadNet Inference at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/)

Subukan ito sa totoong workload mo. May US$5 na panimulang credit ang mga bagong account para sa Gemma at transcription. Kailangan ng top-up para sa DeepSeek, GLM, at Qwen3.8.

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

**Mga source**

-   [API reference ng BroadNet Inference (Ingles)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-openai-node-sdk&utm_content=sources)
-   [OpenAI Node.js library sa npm (7.x, Node.js 22+, sinuri noong 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README ng openai-node, request ID at requirements (sinuri noong 2026-11-14)](https://github.com/openai/openai-node)
