SDK TypeScript compatible OpenAI avec Novita AI : URL de base, ID de modèle et exemples

Si votre stack utilise déjà un SDK IA construit autour d’OpenAI, Novita AI se résume principalement à un changement d’URL de base, de clé API et d’ID 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 à l’adresse https://api.novita.ai/openai/v1/chat/completions, donc la première étape de migration est minime. Si vous choisissez également quel modèle ouvert brancher sur ce SDK, commencez par le Leaderboard des LLM Open Source pour les Agents de Codage en 2026.

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.

C’est particulièrement utile pour :

• Les applications Next.js ou Node qui appellent déjà openai
• Les outils internes qui ont besoin d’un chemin de migration rapide vers le SDK OpenAI
• Les backends d’agents qui seront plus tard associés à Novita Agent Sandbox
• Les équipes qui veulent que TypeScript et Python partagent la même forme API compatible OpenAI

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

Élément	Valeur par défaut 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	ID de modèle OpenAI	ID de modèle Novita	Traitez les ID 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: "Vous êtes un assistant technique concis." },
    { role: "user", content: "Montrez-moi la configuration la plus courte du SDK Novita en TypeScript." },
  ],
});

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

Commencez par les complétions de chat. La documentation publique de Novita documente actuellement le chemin des complétions de chat compatibles OpenAI, c’est donc le test le plus sûr pour commencer.

Équivalent SDK Python 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": "Expliquez la configuration Novita en un paragraphe."}
    ],
)

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 une 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 forme pour les agents de codage.

Si vous migrez plus d’un SDK, consultez également le guide SDK Python OpenAI et le guide API LLM Novita.

Conseils de migration 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 ID de modèle pris en charge par Novita avant de tester. Le code du SDK peut rester le même, mais les ID 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é plus 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 à lui seul ?

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 TypeScript ?

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

Que devrais-je lire ensuite ?

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