OpenAI TypeScript SDK mit Novita AI: Basis-URL, Beispiele und Agent Sandbox

Wenn Ihr Stack bereits ein AI SDK verwendet, das um OpenAI herum aufgebaut ist, erfordert Novita AI im Wesentlichen nur eine Änderung der Basis-URL, des API-Schlüssels und der Modell-ID. Das offizielle OpenAI TypeScript SDK unterstützt benutzerdefinierte Endpunkte, und die Novita-Dokumentation bietet OpenAI-kompatible Chat-Completions unter https://api.novita.ai/openai/v1/chat/completions, sodass der erste Migrationsschritt klein ist.

Das macht Novita zu einer praktischen Option, wenn Sie Ihren bestehenden SDK-Workflow beibehalten und ein anderes Modell-Backend testen möchten, ohne Ihre App neu schreiben zu müssen.

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

Element	OpenAI SDK-Standard	Novita AI-Einrichtung	Warum es wichtig ist
Client-Bibliothek	openai	openai	Behalten Sie das gleiche TypeScript-Paket.
Basis-URL	OpenAI-Endpunkt	https://api.novita.ai/openai	Das SDK fügt den versionierten Pfad hinzu.
API-Schlüssel	OpenAI-Schlüssel	Novita API-Schlüssel	Authentifizierung ändert sich, nicht die Aufrufstruktur.
Modellname	OpenAI-Modell-ID	Novita-Modell-ID	Behandeln Sie Modell-IDs als anbieterabhängig.
Erste Anfrage	chat.completions.create()	chat.completions.create()	Beginnen Sie mit dem gleichen Anfragemuster.

So richten Sie das OpenAI TypeScript SDK mit Novita AI ein

Installieren Sie das SDK:

npm install openai

Dann konfigurieren Sie es für 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);

Beginnen Sie mit Chat-Completions. Die öffentliche Novita-Dokumentation beschreibt derzeit den OpenAI-kompatiblen Pfad für Chat-Completions, daher ist dies der sicherste erste Test.

Python OpenAI SDK-Äquivalent auf Novita AI

Das gleiche 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 Sie den Novita Agent Sandbox mit dem OpenAI SDK verwenden sollten

Verwenden Sie das SDK für Modellaufrufe und den Novita Agent Sandbox, wenn der Workflow Codeausführung, Browser-Aktionen oder Dateiverarbeitung in Isolation erfordert. Diese Trennung hält Inferenz und Ausführung getrennt, was die richtige Struktur für Coding-Agents ist.

Tipps zur OpenAI SDK-Migration für eine bessere Entwicklererfahrung

• Verwenden Sie https://api.novita.ai/openai als Basis-URL des SDK. Das OpenAI SDK hängt den versionierten Pfad automatisch an, sodass Sie /v1 nicht manuell hinzufügen müssen.
• Tauschen Sie vor dem Testen eine von Novita unterstützte Modell-ID ein. Der SDK-Code kann gleich bleiben, aber Modell-IDs sind anbieterspezifisch.
• Behandeln Sie die OpenAI-Kompatibilität als Migrationsabkürzung, nicht als Garantie dafür, dass jede neuere Plattformfunktion gleich funktioniert. Überprüfen Sie vor dem Rollout die aktuelle Novita-Dokumentation.
• Wenn Ihr Workflow generierten Code, Dateioperationen oder Browser-Aktionen ausführt, verlagern Sie die Ausführung in den Agent Sandbox, anstatt sie auf Ihrem lokalen Rechner durchzuführen.

FAQ

Reicht das OpenAI TypeScript SDK allein aus?

Ja für Modellaufrufe. Nein für isolierte Ausführung. Wenn die App agentisch ist, kombinieren Sie es mit dem Agent Sandbox.

Kann ich denselben Code in JavaScript und TypeScript verwenden?

Ja. Die SDK-Nutzung ist identisch.

Was sollte ich als Nächstes lesen?

Lesen Sie den Novita LLM-API-Leitfaden und die Chat-Completions-Referenz und bestätigen Sie dann die genaue Modell-ID in der Modellbibliothek, bevor Sie die Produktion einsetzen.