SDK de TypeScript compatible con OpenAI con Novita AI: URL base, IDs de modelo y ejemplos

Si tu stack ya utiliza un SDK de IA construido alrededor de OpenAI, Novita AI es principalmente un cambio de URL base, clave API e ID de modelo. El SDK oficial de TypeScript de OpenAI admite endpoints personalizados, y la documentación de Novita expone completaciones de chat compatibles con OpenAI en https://api.novita.ai/openai/v1/chat/completions, por lo que el primer paso de migración es pequeño. Si también estás eligiendo qué modelo abierto conectar a ese SDK, comienza con el Open Source LLM Leaderboard for Coding Agents in 2026.

Esto hace que Novita sea una opción práctica cuando quieres mantener tu flujo de trabajo actual del SDK y probar un backend de modelo diferente sin reescribir tu aplicación.

Es especialmente útil para:

• Aplicaciones Next.js o Node que ya llaman a openai
• herramientas internas que necesitan una ruta rápida de migración del SDK de OpenAI
• backends de agentes que luego se emparejarán con Novita Agent Sandbox
• equipos que quieren que TypeScript y Python compartan la misma forma de API compatible con OpenAI

SDK de TypeScript de OpenAI con Novita AI: qué cambia y qué permanece igual

Elemento	Valor por defecto del SDK de OpenAI	Configuración en Novita AI	Por qué es importante
Librería cliente	openai	openai	Mantén el mismo paquete TypeScript.
URL base	endpoint de OpenAI	https://api.novita.ai/openai	El SDK agrega la ruta versionada.
Clave API	Clave de OpenAI	Clave API de Novita	La autenticación cambia, no la forma de la llamada.
Nombre del modelo	ID de modelo de OpenAI	ID de modelo de Novita	Trata los IDs de modelo como específicos del proveedor.
Primera solicitud	chat.completions.create()	chat.completions.create()	Empieza con el mismo patrón de solicitud.

Cómo configurar el SDK de TypeScript de OpenAI con Novita AI

Instala el SDK:

npm install openai

Luego apúntalo a Novita:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.NOVITA_API_KEY,
  baseURL: "https://api.novita.ai/openai",
});

const response = await client.chat.completions.create({
  model: "openai/gpt-oss-120b",
  messages: [
    { role: "system", content: "Eres un asistente técnico conciso." },
    { role: "user", content: "Muéstrame la configuración más corta del SDK de Novita en TypeScript." },
  ],
});

console.log(response.choices[0]?.message?.content);

Comienza con completaciones de chat. La documentación pública de Novita actualmente documenta la ruta de completaciones de chat compatible con OpenAI, por lo que esa es la prueba inicial más segura.

Equivalente del SDK de OpenAI para Python en Novita AI

El mismo patrón funciona en Python:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai",
)

response = client.chat.completions.create(
    model="openai/gpt-oss-120b",
    messages=[
        {"role": "user", "content": "Explica la configuración de Novita en un párrafo."}
    ],
)

print(response.choices[0].message.content)

Cuándo usar Novita Agent Sandbox con el SDK de OpenAI

Usa el SDK para las llamadas al modelo, luego usa Novita Agent Sandbox cuando el flujo de trabajo necesite ejecución de código, acciones del navegador o trabajo con archivos de forma aislada. Esta separación mantiene la inferencia y la ejecución separadas, que es la forma adecuada para los agentes de codificación.

Si estás migrando más de un SDK, consulta también la guía del SDK de OpenAI para Python y la guía de la API LLM de Novita.

Consejos de migración del SDK de OpenAI para una mejor experiencia de desarrollo

• Usa https://api.novita.ai/openai como URL base del SDK. El SDK de OpenAI agrega la ruta versionada por ti, por lo que no necesitas agregar /v1 manualmente.
• Cambia a un ID de modelo compatible con Novita antes de probar. El código del SDK puede permanecer igual, pero los IDs de modelo son específicos del proveedor.
• Trata la compatibilidad con OpenAI como un atajo de migración, no como una garantía de que cada característica más nueva de la plataforma se comporte de la misma manera. Revisa la documentación actual de Novita antes de implementar.
• Si tu flujo de trabajo ejecuta código generado, operaciones de archivos o acciones del navegador, mueve la ejecución a Agent Sandbox en lugar de tu máquina local.

FAQ

¿El SDK de TypeScript de OpenAI es suficiente por sí solo?

Sí para las llamadas al modelo. No para la ejecución aislada. Si la aplicación es agentica, combínalo con Agent Sandbox.

¿Puedo mantener el mismo código en JavaScript y TypeScript?

Sí. El uso del SDK es el mismo.

¿Qué debería leer a continuación?

Lee la guía de la API LLM de Novita y la referencia de completaciones de chat, luego confirma el ID de modelo exacto en la librería de modelos antes de usarlo en producción.