OpenAI TypeScript SDK con Novita AI: URL base, ejemplos y Agent Sandbox

Si tu stack ya usa un SDK de IA construido alrededor de OpenAI, Novita AI es principalmente un cambio de URL base, clave de 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.

Eso convierte a Novita en una opción práctica cuando quieres mantener tu flujo de trabajo actual del SDK y probar un backend de modelos diferente sin reescribir tu aplicación.

OpenAI TypeScript SDK con Novita AI: qué cambia y qué se mantiene igual

Elemento	Configuración por defecto del SDK de OpenAI	Configuración de Novita AI	Por qué es importante
Librería de cliente	openai	openai	Mantén el mismo paquete de TypeScript.
URL base	Endpoint de OpenAI	https://api.novita.ai/openai	El SDK añade la ruta versionada.
Clave de API	Clave de OpenAI	Clave de API de Novita	Cambia la autenticación, no la forma de la llamada.
Nombre del modelo	ID de modelo de OpenAI	ID de modelo de Novita	Trata los ID de modelo como específicos del proveedor.
Primera solicitud	chat.completions.create()	chat.completions.create()	Comienza 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: "You are a concise technical assistant." },
    { role: "user", content: "Show me the shortest Novita SDK setup in TypeScript." },
  ],
});

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

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

Equivalente del SDK de OpenAI en Python para 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": "Explain the Novita setup in one paragraph."}
    ],
)

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 y luego usa Novita Agent Sandbox cuando el flujo de trabajo necesite ejecución de código, acciones de navegador o trabajo con archivos de forma aislada. Esa división mantiene la inferencia y la ejecución separadas, lo cual es la forma adecuada para agentes de codificación.

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 añade la ruta versionada automáticamente, así que no necesitas agregar /v1 manualmente.
• Cambia a un ID de modelo compatible con Novita antes de probar. El código del SDK puede mantenerse igual, pero los ID 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 todas las funciones más recientes de la plataforma se comporten igual. Consulta la documentación actual de Novita antes del lanzamiento.
• Si tu flujo de trabajo ejecuta código generado, operaciones de archivos o acciones de navegador, mueve la ejecución a Agent Sandbox en lugar de a tu máquina local.

Preguntas frecuentes

¿Es suficiente el SDK de TypeScript de OpenAI por sí solo?

Sí para llamadas al modelo. No para ejecución aislada. Si la aplicación está basada en agentes, úsalo junto 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 y luego confirma el ID de modelo exacto en la biblioteca de modelos antes de usarlo en producción.