---
title: "SDK Node.js da OpenAI com baseURL personalizada | BroadRouter"
description: "Aponte o SDK oficial da OpenAI para Node.js e TypeScript para a BroadNet Inference com baseURL. Instale, faça a primeira requisição, use streaming e registre IDs."
url: https://broadrouter.com/pt/guides/openai-node-sdk/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/openai-node-sdk/) (atualizado em 2026-11-16).

# Como usar o SDK Node.js da OpenAI com a BroadNet Inference

Atualizado em 2026-11-16

Instale o pacote npm openai e crie o client com baseURL definida como https://inference.broadnet.ai/v1 e apiKey com a sua chave da BroadNet. O código chat.completions que você já tem continua funcionando; mude só o ID do modelo, por exemplo broadnet/deepseek-v4.1-flash. A BroadNet oferece chat completions, não a Responses API, então continue usando client.chat.completions.create.

Você precisa de uma chave de inferência da [sua conta na BroadNet Inference](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-openai-node-sdk&utm_content=body). Contas novas começam com $5 de crédito e sem cartão. Se você usa Python, veja [o guia do SDK Python](https://broadrouter.com/pt/guides/openai-python-sdk/).

## 1\. Instale e defina a chave

O pacote `openai` atual (7.x) exige Node.js 22 ou mais recente.

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

## 2\. Primeira requisição

Salve como `first-request.mjs` e rode `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` funciona com o crédito gratuito. Para o modelo dos planos ilimitados, use `broadnet/deepseek-v4.1-flash` e defina `max_tokens` como 1.000 ou mais, porque o raciocínio dele conta para o limite. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).

## 3\. Streaming de tokens

```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\. Registre o ID da requisição

```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);
```

O SDK lê `request_id` do cabeçalho `x-request-id`. As respostas já interpretadas também o trazem como `data._request_id`.

Guarde esse ID junto com o horário UTC, a rota e o status: o suporte da BroadNet pede essas informações. [Códigos de erro e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/).

## Solução de problemas

-   **401.** A chave está errada, expirou ou ficou sem cota de pagamento por uso. Se `BROADNET_API_KEY` não estiver definida, `apiKey` fica `undefined` e o SDK recorre a `OPENAI_API_KEY`, ou lança um erro se ela também estiver faltando.
-   **404.** Confira se `baseURL` termina em `/v1` e se você chama `chat.completions`, não `responses`. Depois confira o ID do modelo, com o prefixo `broadnet/`.
-   **Modelo pago falha em uma conta nova.** O crédito inicial de $5 cobre o BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) e os dois modelos BroadNet Transcribe. Faça uma recarga para usar os outros modelos de chat: DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B.
-   **`content` vazio.** O raciocínio conta para `max_tokens`. Aumente o valor ou deixe-o sem definir. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 ao mesmo tempo. Por padrão, o SDK tenta de novo duas vezes; ajuste `maxRetries` no client. Para streams interrompidos, veja [streaming de chat completions](https://broadrouter.com/pt/guides/streaming-chat-completions/).

## Termos neste guia

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

Streaming é uma forma de devolver a resposta de um modelo de linguagem em pequenos pedaços enquanto ela ainda está sendo gerada, em vez de uma resposta única no final. APIs compatíveis com a OpenAI fazem streaming via server-sent events quando a requisição define stream como true.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

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

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

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

A Chat Completions API é o endpoint HTTP da OpenAI, POST /v1/chat/completions, que recebe o nome de um modelo e uma lista de mensagens marcadas com papéis e devolve a próxima mensagem do modelo. O formato da requisição e da resposta virou o padrão comum que provedores e SDKs compatíveis com a OpenAI reutilizam.

[Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/)

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

[Crédito pré-pago (prepaid credit)](https://broadrouter.com/pt/glossary/prepaid-credit/)

Crédito pré-pago é dinheiro adicionado a uma conta de API antes do uso. Cada requisição desconta o próprio custo do saldo e, quando o saldo acaba, as requisições cobradas por uso param até você fazer uma recarga. Ele limita o gasto ao que você já pagou.

## Perguntas frequentes

### Dá para definir a base URL da BroadNet com uma variável de ambiente no Node?

Sim. O SDK lê OPENAI\_BASE\_URL quando você não passa baseURL, e OPENAI\_API\_KEY quando você não passa apiKey. Passar os dois de forma explícita evita mandar, por engano, uma chave da BroadNet para a OpenAI, ou o contrário.

### client.responses.create funciona com a BroadNet?

Não. A documentação da BroadNet lista apenas chat completions e audio transcriptions. Para chat, use client.chat.completions.create.

### Qual versão do Node.js o pacote openai exige?

A versão 7.x atual declara Node.js 22 ou mais recente. Deno, Bun, Cloudflare Workers e Vercel Edge também são suportados.

### Posso chamar a BroadNet pelo navegador com o SDK Node?

Não faça isso. O SDK bloqueia o uso no navegador a menos que você defina dangerouslyAllowBrowser, porque a chave iria para todos os visitantes. Chame a BroadNet a partir do seu servidor.

## Guias relacionados

-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/)
-   [Streaming de chat completions e conexões que caem](https://broadrouter.com/pt/guides/streaming-chat-completions/)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

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

**Fontes**

-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-openai-node-sdk&utm_content=sources)
-   [Biblioteca Node.js da OpenAI no npm (7.x, Node.js 22+, conferido em 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README do openai-node, IDs de requisição e requisitos (conferido em 2026-11-14)](https://github.com/openai/openai-node)
