¿Cómo usar el SDK de OpenAI en Node.js con una API compatible (base URL + clave)?

Receta en Node.js para usar el paquete oficial openai con cualquier API compatible cambiando la URL base y la clave, con Dongee AI Router como ejemplo: código, streaming, manejo de errores y dónde guardar la clave.

Para usar el SDK de OpenAI en Node.js con una API compatible, instala el paquete oficial openai y crea el cliente con dos parámetros: baseURL, que apunta a la URL base de tu proveedor, y apiKey, con la clave que te da ese proveedor. El resto del código se escribe igual que con la API original: chat completions, streaming y manejo de errores. En esta receta usamos Dongee AI Router como ejemplo. El patrón sirve para cualquier API compatible con el estándar OpenAI.

Qué necesitas antes de empezar

  • Node.js 20 o superior y npm.
  • Un proyecto con módulos ESM. Usa archivos .mjs o pon "type": "module" en tu package.json.
  • Una API compatible con el estándar OpenAI. Necesitas su URL base, una clave y el nombre exacto del modelo.

Dongee AI Router es una API unificada que da acceso a varios modelos de IA con una sola clave. Da prioridad a modelos rápidos alojados en el data center de Dongee en Canadá. Funciona con prepago desde 3 USD, sin mensualidad. Para pasar tu código a AI Router solo cambias la URL base y la clave.

Paso a paso con Dongee AI Router

  1. Activa AI Router y carga saldo. Se activa desde tu área de cliente, así que necesitas ser cliente de Dongee. Las cuentas nuevas reciben un crédito de bienvenida. Si se acaba el saldo, las peticiones se detienen y no se genera deuda.
  2. Crea una clave. Puedes crear todas las claves que quieras por cuenta. Te recomendamos limitar cada una a los modelos que de verdad uses. Los detalles están en la guía para limitar una clave API a ciertos modelos de IA.
  3. Copia la URL base y el nombre del modelo. Los dos aparecen en tu área de cliente. Copia el nombre del modelo tal cual aparece en la lista: si difiere en una sola letra, la petición fallará.
  4. Configura las variables de entorno en el servidor. En esta guía usamos AI_ROUTER_BASE_URL, AI_ROUTER_API_KEY y AI_MODEL. Son nombres de ejemplo y puedes cambiarlos.
  5. Escribe el código (lo verás en la siguiente sección).
  6. Prueba y revisa el consumo. En el área de cliente ves el consumo por modelo, por clave y el detalle de cada petición.

Receta de código en Node.js (ESM)

1. Instala el paquete

npm install openai

2. Variables de entorno (archivo .env local, nunca en el repo)

AI_ROUTER_BASE_URL="<URL base de tu área de cliente>"
AI_ROUTER_API_KEY="<tu clave>"
AI_MODEL="<modelo de la lista>"

En Node 20 o superior puedes cargar el archivo sin librerías extra con node --env-file=.env app.mjs.

3. Cliente y petición normal

// app.mjs
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: process.env.AI_ROUTER_BASE_URL,
  apiKey: process.env.AI_ROUTER_API_KEY,
});

const model = process.env.AI_MODEL;

try {
  const res = await client.chat.completions.create({
    model,
    messages: [
      { role: "system", content: "Responde en español, breve." },
      { role: "user", content: "¿Qué es una URL base?" },
    ],
  });
  console.log(res.choices[0].message.content);
} catch (err) {
  if (err instanceof OpenAI.APIError) {
    console.error("Error de la API:", err.status, err.message);
  } else {
    console.error("Error de red o de código:", err);
  }
}

4. Petición con streaming

AI Router admite streaming. Agrega stream: true y recorre la respuesta con for await:

try {
  const stream = await client.chat.completions.create({
    model,
    messages: [{ role: "user", content: "Escribe tres ideas de nombres para un blog." }],
    stream: true,
  });
  for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
  }
} catch (err) {
  console.error("Falló el stream:", err.message);
}

El try/catch sirve para que tu app no se caiga y muestre un mensaje útil. Registra el estado y el mensaje que devuelve la API para diagnosticar. No escribas lógica que dependa de códigos de error concretos sin revisarlos antes en tus propias pruebas.

Seguridad: dónde va la clave

  • Nunca en el navegador. Si la clave llega al frontend, cualquiera puede verla y gastar tu saldo. El navegador debe llamar a tu backend, y es tu backend el que llama a la API.
  • Nunca en el repositorio. Agrega .env a .gitignore antes del primer commit. Esto aplica también si generas el proyecto con Lovable, Bolt, v0, Cursor, Claude Code o Codex y lo subes a GitHub.
  • Una clave por app o entorno. Como no hay límite de claves, puedes separar desarrollo y producción. Así ves el consumo de cada una por separado.

AI Router no guarda tus conversaciones. Solo registra los datos de facturación de cada petición, nunca el contenido.

Si publicas la app en Dongee Live

Dongee Live publica apps hechas con IA. No publica ni despliega modelos de IA: tu app Node.js corre en Live y llama al modelo a través de AI Router. Live admite Node.js 20, 22 y 24, y tiene sus propias variables de entorno, también en Live Gratis (0 USD, 1 app). Ahí guardas AI_ROUTER_BASE_URL, AI_ROUTER_API_KEY y AI_MODEL sin tocar el código. Si tu app además usa base de datos, mira cómo publicar una app Node.js con MySQL desde Claude Code o Cursor.

Comparación honesta: ¿API unificada o llamar directo a cada proveedor?

CriterioAPI compatible unificada (p. ej., AI Router)Directo a cada proveedor
CódigoUn solo SDK y una sola URL baseUn SDK o configuración distinta por proveedor
ClavesUna clave para varios modelosUna clave por proveedor
Cambiar de modeloCambias AI_MODELPuede requerir cambiar el código
Funciones exclusivas de un proveedorSolo lo que cubre el estándar OpenAIAcceso completo a todo lo propio
Fallback entre modelosLo programas tú (AI Router no hace fallback propio)También lo programas tú

Cuándo NO conviene Dongee AI Router: si dependes de funciones que solo ofrece un proveedor y no forman parte del estándar OpenAI, si necesitas un modelo que no está en la lista o si quieres que el servicio haga fallback automático por ti. En esos casos, llamar directo a ese proveedor es la opción más simple. Si lo que buscas es gastar menos, lee cómo optimizar el consumo de tokens con enrutadores de IA. Para repartir peticiones entre modelos, mira el enrutamiento inteligente entre modelos de lenguaje.

Preguntas frecuentes

¿Sirve con LangChain u otras librerías?

Si la librería te deja cambiar la URL base y la clave de su cliente compatible con OpenAI, el patrón es el mismo. Prueba en tu proyecto antes de llevarlo a producción.

¿Puedo usarlo detrás de un gateway como LiteLLM?

Sí. Puedes poner AI Router detrás de tu propio gateway, tipo LiteLLM, y configurarlo con la URL base y la clave.

¿Dónde encuentro la URL base y los nombres de modelo?

En tu área de cliente, una vez que actives AI Router. Copia el nombre del modelo exactamente como aparece en la lista.

¿Qué pasa si se me acaba el saldo?

Las peticiones se detienen y no se genera deuda. Tu código debe capturar ese error con try/catch para avisar al usuario sin que la app se caiga.

¿Puedo llamar a la API directamente desde React o desde el navegador?

No es recomendable: la clave quedaría expuesta y cualquiera podría usar tu saldo. Crea un endpoint en tu servidor Node.js y llama a la API desde ahí.

En resumen

Con el SDK oficial openai, conectarte a una API compatible se reduce a configurar baseURL y apiKey desde variables de entorno y elegir el modelo con su nombre exacto. Guarda la clave en el servidor, revisa el consumo en tu área de cliente y cambia de modelo cuando lo necesites sin reescribir tu app.

Comenta lo que quieras

Unete a la charla
Solo ingresa tu email