SDK TypeScript OpenAI avec Novita AI : URL de base, exemples et Agent Sandbox

Si votre stack utilise déjà un SDK IA basé sur OpenAI, Novita AI se résume principalement à un changement d’URL de base, de clé API et d’identifiant de modèle. Le SDK TypeScript officiel d’OpenAI prend en charge les endpoints personnalisés, et la documentation de Novita expose des complétions de chat compatibles OpenAI sur https://api.novita.ai/openai/v1/chat/completions. La première étape de migration est donc minime.

Cela fait de Novita un choix pratique lorsque vous souhaitez conserver votre flux de travail SDK existant et tester un backend de modèle différent sans réécrire votre application.

SDK TypeScript OpenAI avec Novita AI : ce qui change et ce qui reste identique

Élément	Défaut du SDK OpenAI	Configuration Novita AI	Pourquoi c’est important
Bibliothèque client	openai	openai	Conservez le même package TypeScript.
URL de base	Endpoint OpenAI	https://api.novita.ai/openai	Le SDK ajoute le chemin versionné.
Clé API	Clé OpenAI	Clé API Novita	L’authentification change, pas la forme de l’appel.
Nom du modèle	Identifiant de modèle OpenAI	Identifiant de modèle Novita	Traitez les identifiants de modèle comme spécifiques au fournisseur.
Première requête	chat.completions.create()	chat.completions.create()	Commencez avec le même modèle de requête.

Comment configurer le SDK TypeScript OpenAI avec Novita AI

Installez le SDK :

npm install openai

Puis pointez-le vers 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);

Commencez par les complétions de chat. La documentation publique de Novita documente actuellement le parcours de complétions de chat compatible OpenAI, c’est donc le premier test le plus sûr.

Équivalent Python du SDK OpenAI sur Novita AI

Le même modèle fonctionne 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)

Quand utiliser Novita Agent Sandbox avec le SDK OpenAI

Utilisez le SDK pour les appels de modèle, puis utilisez Novita Agent Sandbox lorsque le workflow nécessite l’exécution de code, des actions de navigateur ou un travail sur fichiers de manière isolée. Cette séparation maintient l’inférence et l’exécution distinctes, ce qui est la bonne approche pour les agents de codage.

Conseils de migration du SDK OpenAI pour une meilleure expérience développeur

• Utilisez https://api.novita.ai/openai comme URL de base du SDK. Le SDK OpenAI ajoute le chemin versionné pour vous, vous n’avez donc pas besoin d’ajouter /v1 manuellement.
• Remplacez par un identifiant de modèle pris en charge par Novita avant de tester. Le code du SDK peut rester le même, mais les identifiants de modèle sont spécifiques au fournisseur.
• Considérez la compatibilité OpenAI comme un raccourci de migration, pas comme une garantie que chaque fonctionnalité récente de la plateforme se comporte de la même manière. Vérifiez la documentation actuelle de Novita avant le déploiement.
• Si votre workflow exécute du code généré, des opérations sur fichiers ou des actions de navigateur, déplacez l’exécution dans Agent Sandbox plutôt que sur votre machine locale.

FAQ

Le SDK TypeScript OpenAI suffit-il en soi ?

Oui pour les appels de modèle. Non pour l’exécution isolée. Si l’application est agentique, associez-le à Agent Sandbox.

Puis-je conserver le même code en JavaScript et en TypeScript ?

Oui. L’utilisation du SDK est la même.

Que devrais-je lire ensuite ?

Lisez le guide de l’API LLM Novita et la référence des complétions de chat, puis confirmez l’identifiant de modèle exact dans la bibliothèque de modèles avant une utilisation en production.