---
title: "SDK de OpenAI para Node.js con baseURL propia (BroadNet)"
description: "Apunte el SDK oficial de OpenAI para Node.js y TypeScript a BroadNet Inference con baseURL: instalación, primera solicitud, streaming e IDs de solicitud."
url: https://broadrouter.com/es/guides/openai-node-sdk/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/openai-node-sdk/) (actualizado el 2026-11-16).

# Usar el SDK de OpenAI para Node.js con BroadNet Inference

Actualizado 2026-11-16

Instale el paquete npm openai y cree el cliente con baseURL en https://inference.broadnet.ai/v1 y apiKey con su clave de BroadNet. Su código actual de chat.completions sigue funcionando; cambie solo el ID del modelo, por ejemplo broadnet/deepseek-v4.1-flash. BroadNet ofrece chat completions, no la Responses API, así que siga usando client.chat.completions.create.

Necesita una clave de inferencia de [su cuenta de BroadNet Inference](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-openai-node-sdk&utm_content=body). Las cuentas nuevas empiezan con $5 de crédito y sin tarjeta. Si usa Python, consulte [la guía del SDK para Python](https://broadrouter.com/es/guides/openai-python-sdk/).

## 1\. Instale el paquete y configure la clave

El paquete `openai` actual (7.x) requiere Node.js 22 o posterior.

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

## 2\. Primera solicitud

Guárdelo como `first-request.mjs` y ejecute `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 con el crédito gratuito. Para el modelo del plan ilimitado, use `broadnet/deepseek-v4.1-flash` y configure `max_tokens` en 1,000 o más, porque su razonamiento cuenta para ese límite. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).

## 3\. Reciba los tokens en streaming

```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 el ID de la solicitud

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

El SDK lee `request_id` del encabezado `x-request-id`. Las respuestas ya procesadas también lo incluyen como `data._request_id`.

Guarde ese ID con la hora UTC, la ruta y el código de estado: el soporte de BroadNet los solicita. [Códigos de error y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/).

## Solución de problemas

-   **401.** La clave es incorrecta, venció o se agotó la asignación de pago por uso. Si `BROADNET_API_KEY` no está definida, `apiKey` es `undefined` y el SDK recurre a `OPENAI_API_KEY`, o lanza un error si esa también falta.
-   **404.** Verifique que `baseURL` termine en `/v1` y que llame a `chat.completions`, no a `responses`. Luego revise el ID del modelo, con el prefijo `broadnet/`.
-   **Un modelo de pago falla en una cuenta nueva.** El crédito inicial de $5 cubre BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) y los dos modelos BroadNet Transcribe. Recargue para usar los demás modelos de chat: DeepSeek V4.1 Flash, GLM 5.3 y Qwen3.8 27B.
-   **`content` vacío.** El razonamiento cuenta para `max_tokens`. Súbalo o déjelo sin definir. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **429.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 simultáneas. El SDK reintenta dos veces de forma predeterminada; ajuste `maxRetries` en el cliente. Consulte [streaming de chat completions](https://broadrouter.com/es/guides/streaming-chat-completions/) para los streams interrumpidos.

## Términos de esta guía

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

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Streaming (respuestas en tiempo real)](https://broadrouter.com/es/glossary/streaming/)

El streaming es una forma de devolver la respuesta de un modelo de lenguaje en pequeños fragmentos mientras aún se genera, en lugar de una sola respuesta al final. Las APIs compatibles con OpenAI hacen streaming mediante server-sent events cuando la solicitud define stream como true.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

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

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

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

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

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

Una clave de API es una cadena secreta que identifica y autoriza a un cliente que llama a una API. Las APIs de LLM suelen esperarla en un encabezado Authorization: Bearer, y cualquiera que tenga la clave puede hacer solicitudes que se facturan a la cuenta propietaria.

## Preguntas frecuentes

### ¿Puedo configurar la URL base de BroadNet con una variable de entorno en Node?

Sí. El SDK lee OPENAI\_BASE\_URL cuando no pasa baseURL, y OPENAI\_API\_KEY cuando no pasa apiKey. Pasar ambos valores de forma explícita evita enviar por error una clave de BroadNet a OpenAI, o al revés.

### ¿Funciona client.responses.create con BroadNet?

No. La documentación de BroadNet solo incluye chat completions y transcripciones de audio. Use client.chat.completions.create para el chat.

### ¿Qué versión de Node.js necesita el paquete openai?

La versión actual 7.x declara Node.js 22 o posterior. También son compatibles Deno, Bun, Cloudflare Workers y Vercel Edge.

### ¿Puedo llamar a BroadNet desde el navegador con el SDK de Node?

No lo haga. El SDK bloquea el uso en el navegador a menos que configure dangerouslyAllowBrowser, porque la clave llegaría a cada visitante. Llame a BroadNet desde su servidor.

## Guías relacionadas

-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

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

**Fuentes**

-   [Referencia de la API de BroadNet Inference (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-openai-node-sdk&utm_content=sources)
-   [Biblioteca de OpenAI para Node.js en npm (7.x, Node.js 22+, consultado el 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README de openai-node: IDs de solicitud y requisitos (consultado el 2026-11-14)](https://github.com/openai/openai-node)
