Vercel AI SDK

Vercels AI SDK ist das Standard-Toolkit, um KI-Funktionen in TypeScript zu bauen. Richten Sie seinen @ai-sdk/openai-compatible Provider auf Synthorai aus, und der gesamte Katalog steht hinter einem Schlüssel bereit - Claude, GPT, Gemini und Open-Weight-Familien nebeneinander.

Bevor Sie starten

Erstellen Sie einen API-Schlüssel unter Console → API Keys. Kopieren Sie ihn sofort - er wird nur einmal angezeigt.

Schritt 1 - Pakete installieren

npm i ai @ai-sdk/openai-compatible

Synthorai spricht das OpenAI-Chat-Completions-Format, daher ist kein Synthorai-spezifisches Paket nötig - der offizielle OpenAI-kompatible Provider ist der unterstützte Weg.

Schritt 2 - Provider-Instanz erstellen

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';

const synthorai = createOpenAICompatible({
  name: 'synthorai',
  baseURL: 'https://synthorai.io/v1',
  apiKey: process.env.SYNTHORAI_API_KEY,
});

Der Wert name ist ein Label für Traces und Fehlermeldungen und beeinflusst das Routing nicht. Über das Routing entscheiden baseURL und die übergebene Modell-ID.

⚠

Die Basis-URL muss auf /v1. enden. Der Provider hängt Pfade wie /chat/completions an, sodass sie ohne diesen Teil auf den falschen Pfad zeigt.

Schritt 3 - Text erzeugen und streamen

import { generateText } from 'ai';

const { text } = await generateText({
  model: synthorai('claude-sonnet-5-5'),
  prompt: 'Tell me about yourself in one sentence.',
});

console.log(text);

Das erste Argument ist eine Modell-ID aus dem Katalog. Streaming läuft über dieselbe Provider-Instanz, ohne zusätzliche Konfiguration:

import { streamText } from 'ai';

const result = streamText({
  model: synthorai('claude-sonnet-5-5'),
  prompt: 'Write a short haiku about routing.',
});

for await (const textPart of result.textStream) {
  process.stdout.write(textPart);
}

Modellwahl

Jede Modell-ID aus dem Katalog funktioniert. Sinnvolle Voreinstellungen:

Parameter	Typ	Beschreibung
`claude-opus-5-5`	`agentic`	Eine solide Wahl für lange Agenten-Sessions und Code-Bearbeitung.
`gpt-5.4`	`reasoning`	Allgemeines Reasoning über gemischte Workloads.
`gpt-5.4-mini`	`fast`	Schnell und günstig - gut für Klassifikation und kurze Completions.
`deepseek-v4-flash`	`cheapest`	Eines der günstigsten Modelle im Katalog - geeignet für hohe Volumina.

Stattdessen die Anthropic-Oberfläche nutzen

Derselbe Schlüssel bedient unter einem anderen Pfad auch das Anthropic-Messages-Format, das das AI SDK über seinen Anthropic-Provider erreicht. Nutzen Sie das für Anthropic-native Funktionen und ansonsten den OpenAI-kompatiblen Provider oben.

import { createAnthropic } from '@ai-sdk/anthropic';

const synthoraiAnthropic = createAnthropic({
  baseURL: 'https://synthorai.io/v1',
  apiKey: process.env.SYNTHORAI_API_KEY,
});

⚠

Beachten Sie den Unterschied zum nativen Anthropic-SDK: Dieses nimmt die Host-Wurzel und hängt /v1/messages selbst an, während der Anthropic-Provider des AI SDK einen Präfix erwartet, der /v1 bereits enthält. Nur der Host führt hier auf den falschen Pfad.

Fehlerbehebung

404 bei jedem Aufruf. Die Basis-URL muss auf /v1. enden. Der Provider hängt Pfade wie /chat/completions an, sodass sie ohne diesen Teil auf den falschen Pfad zeigt.

401 Unauthorized. Die Umgebungsvariable wird beim Laden des Moduls gelesen; ein nach dem Prozessstart exportierter Schlüssel wird nicht übernommen. Starten Sie den Prozess danach neu.

Modell nicht gefunden. Modell-IDs unterscheiden Groß- und Kleinschreibung und müssen exakt dem Katalog entsprechen. Erreichbare Modelle auflisten mit: curl https://synthorai.io/v1/models -H "Authorization: Bearer $SYNTHORAI_API_KEY"

Jede Modell-ID und ihr Preis stehen im model price comparison.