OpenAI SDK para JavaScript (Node.js): guía completa con ejemplos

Bienvenido a la guía más completa sobre el uso del SDK oficial de OpenAI para JavaScript en el entorno Node.js. Este artículo ha sido creado especialmente para el portal educativo PythonLib, con el objetivo de ayudar a desarrolladores de cualquier nivel a integrar de forma rápida y eficiente las capacidades de inteligencia artificial de OpenAI en sus aplicaciones web, bots y soluciones de servidor.

1. ¿Qué es y para qué sirve?

El SDK de OpenAI para JavaScript es la biblioteca oficial proporcionada por OpenAI para interactuar con su API desde aplicaciones escritas en JavaScript (Node.js). Actúa como un envoltorio práctico sobre la API REST, encargándose de todo el trabajo repetitivo: construcción de solicitudes HTTP, procesamiento de respuestas, gestión de autenticación, reintentos automáticos ante errores de red y transmisión de datos en streaming. En lugar de escribir manualmente solicitudes fetch, procesar JSON y gestionar tokens, obtienes una interfaz intuitiva con métodos cuyos nombres lo dicen todo: chat.completions.create(), embeddings.create(), images.generate() y muchos más.

¿Para qué sirve esta biblioteca? Primero, acelera drásticamente el desarrollo. En lugar de docenas de líneas de código para una sola solicitud a ChatGPT, escribes solo 3-5 líneas. Segundo, el SDK maneja automáticamente aspectos complejos como el streaming, donde la respuesta del modelo llega en partes, algo esencial para crear interfaces de chat que muestren texto en tiempo real. Tercero, la biblioteca ofrece soporte nativo para TypeScript, proporcionando tipado completo para todas las solicitudes y respuestas, lo que permite detectar errores en la fase de escritura del código, no durante la ejecución. Por último, es la herramienta oficial, que se actualiza junto con la API, garantizando acceso a los modelos y funciones más recientes como GPT-4o, DALL-E 3, Whisper y TTS.

Esta biblioteca es ideal para crear chatbots, asistentes inteligentes, sistemas de análisis de texto, generación de contenido, traducción, resumen, así como para la integración con frameworks como Express.js, Next.js o la API de Telegram Bot. Si programas en Node.js y quieres añadir "cerebro" a tu proyecto con OpenAI, este SDK es tu mejor opción.

2. Instalación

La instalación de la biblioteca se realiza a través del gestor de paquetes npm. Asegúrate de tener instalado Node.js versión 18 o superior (se recomienda la 20 LTS).

Comando exacto para instalar:

npm install openai

Si usas yarn:

yarn add openai

Después de la instalación, necesitarás una clave de API de OpenAI. Puedes obtenerla en la página platform.openai.com/api-keys. La clave debe almacenarse de forma segura, por ejemplo, en una variable de entorno llamada OPENAI_API_KEY.

3. Inicio rápido: ejemplo mínimo funcional

Escribamos un script sencillo que haga una pregunta al modelo GPT-4o y muestre la respuesta. Crea un archivo quickstart.mjs (usando módulos ES) o quickstart.js (para CommonJS).

// quickstart.mjs — usando módulos ES
import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env["OPENAI_API_KEY"], // clave desde variable de entorno
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: "gpt-4o",
    messages: [
      { role: "system", content: "Eres un asistente útil." },
      { role: "user", content: "Escribe un saludo breve en español." },
    ],
  });

  console.log(completion.choices[0].message.content);
}

main();

Ejecuta el script:

export OPENAI_API_KEY="sk-..." # Linux/macOS
set OPENAI_API_KEY="sk-..."   # Windows
node quickstart.mjs