OpenAI-kompatibles TypeScript SDK mit Novita AI: Basis-URL, Modell-IDs und Beispiele

Wenn dein Stack bereits ein AI-SDK verwendet, das auf OpenAI basiert, besteht die Umstellung auf Novita AI hauptsächlich aus einer Änderung von Basis-URL, API-Schlüssel und Modell-ID. Das offizielle OpenAI TypeScript SDK unterstützt benutzerdefinierte Endpunkte, und die Novita-Dokumentation stellt OpenAI-kompatible Chat-Completions unter https://api.novita.ai/openai/v1/chat/completions bereit, sodass der erste Migrationsschritt klein ist. Wenn du außerdem ein offenes Modell für das SDK auswählst, beginne mit dem Open-Source-LLM-Leaderboard für Coding-Agenten in 2026.

Das macht Novita zu einer praktischen Wahl, wenn du deinen bestehenden SDK-Workflow beibehalten und ohne Umschreiben deiner App ein anderes Modell-Backend testen möchtest.

Besonders nützlich ist das für:

• Next.js- oder Node-Apps, die bereits openai aufrufen
• interne Tools, die einen schnellen OpenAI-SDK-Migrationspfad benötigen
• Agent-Backends, die später mit Novita Agent Sandbox kombiniert werden
• Teams, die möchten, dass TypeScript und Python dieselbe OpenAI-kompatible API-Struktur nutzen

OpenAI TypeScript SDK mit Novita AI: Was sich ändert und was gleich bleibt

Element	OpenAI-SDK-Standard	Novita-AI-Einrichtung	Warum das wichtig ist
Client-Bibliothek	openai	openai	Behalte dasselbe TypeScript-Paket bei.
Basis-URL	OpenAI-Endpunkt	https://api.novita.ai/openai	Das SDK ergänzt den versionierten Pfad.
API-Schlüssel	OpenAI-Schlüssel	Novita-API-Schlüssel	Die Authentifizierung ändert sich, nicht die Aufrufstruktur.
Modellname	OpenAI-Modell-ID	Novita-Modell-ID	Behandle Modell-IDs als anbieterabhängig.
Erste Anfrage	chat.completions.create()	chat.completions.create()	Beginne mit demselben Anfragemuster.

So richtest du das OpenAI TypeScript SDK mit Novita AI ein

Installiere das SDK:

npm install openai

Dann richtest du es auf Novita aus:

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);

Beginne mit Chat-Completions. Die öffentliche Novita-Dokumentation beschreibt derzeit den OpenAI-kompatiblen Chat-Completions-Pfad, daher ist das der sicherste erste Test.

Python-OpenAI-SDK-Äquivalent auf Novita AI

Dasselbe Muster funktioniert in 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)

Wann du Novita Agent Sandbox mit dem OpenAI SDK verwenden solltest

Nutze das SDK für Modellaufrufe und verwende Novita Agent Sandbox, wenn der Workflow Codeausführung, Browser-Aktionen oder Arbeiten mit Dateien in isolierter Umgebung benötigt. Diese Trennung hält Inferenz und Ausführung getrennt, was die richtige Struktur für Coding-Agenten ist.

Wenn du mehr als ein SDK migrierst, wirf auch einen Blick auf den OpenAI-Python-SDK-Leitfaden und den Novita-LLM-API-Leitfaden.

OpenAI-SDK-Migrationstipps für eine bessere Developer Experience

• Verwende https://api.novita.ai/openai als Basis-URL des SDKs. Das OpenAI SDK hängt den versionierten Pfad automatisch an, du musst also /v1 nicht manuell hinzufügen.
• Setze vor dem Testen eine von Novita unterstützte Modell-ID ein. Der SDK-Code kann gleich bleiben, aber Modell-IDs sind anbieterabhängig.
• Behandle die OpenAI-Kompatibilität als Migrationsabkürzung, nicht als Garantie, dass jedes neuere Plattform-Feature sich identisch verhält. Prüfe vor dem Rollout die aktuelle Novita-Dokumentation.
• Wenn dein Workflow generierten Code, Dateioperationen oder Browser-Aktionen ausführt, verschiebe die Ausführung in Agent Sandbox statt auf deine lokale Maschine.

FAQ

Reicht das OpenAI TypeScript SDK allein aus?

Ja für Modellaufrufe. Nein für isolierte Ausführung. Wenn die App agentisch ist, kombiniere sie mit Agent Sandbox.

Kann ich denselben Code in JavaScript und TypeScript verwenden?

Ja. Die SDK-Nutzung ist identisch.

Was sollte ich als Nächstes lesen?

Lies den Novita-LLM-API-Leitfaden und die Chat-Completions-Referenz und bestätige dann vor dem Produktiveinsatz die genaue Modell-ID in der Modellbibliothek.