Von OpenRouter umsteigen

Eine bestehende OpenRouter-Anbindung auf Tokenlane umstellen: Zwei Werte ändern sich, einiges verhält sich anders.

Verbindung umstellen

Zuerst Tokenlane einrichten: Organisation freischalten, Guthaben aufladen und einen Inferenz-Key anlegen (Schnellstart, Schritte 1, 2 und 4). OpenRouter-Keys funktionieren hier nicht. Dann Basis-URL und Key tauschen. Die gesamte Basis-URL ersetzen: Aus https://openrouter.ai/api/v1 wird https://api.tokenlane.de/v1. Nur den Host zu ändern lässt /api/v1 stehen und führt zu 404 not_found. Modell, Nachrichten und Parameter bleiben. Die Header HTTP-Referer und X-Title dürfen bleiben und werden ignoriert.

curl

-curl 'https://openrouter.ai/api/v1/chat/completions' \
-  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
+curl 'https://api.tokenlane.de/v1/chat/completions' \
+  -H "Authorization: Bearer $TOKENLANE_API_KEY" \
   -H "Content-Type: application/json" \

node

 const client = new OpenAI({
-  baseURL: "https://openrouter.ai/api/v1",
-  apiKey: process.env.OPENROUTER_API_KEY,
+  baseURL: "https://api.tokenlane.de/v1",
+  apiKey: process.env.TOKENLANE_API_KEY,
 });

python

 client = OpenAI(
-    base_url="https://openrouter.ai/api/v1",
-    api_key=os.environ["OPENROUTER_API_KEY"],
+    base_url="https://api.tokenlane.de/v1",
+    api_key=os.environ["TOKENLANE_API_KEY"],
 )

vercel

 import { createOpenRouter } from '@openrouter/ai-sdk-provider';
 
-const provider = createOpenRouter({ apiKey: process.env.OPENROUTER_API_KEY });
+const provider = createOpenRouter({
+  baseURL: "https://api.tokenlane.de/v1",
+  apiKey: process.env.TOKENLANE_API_KEY,
+});

Vercel AI SDK

Wer bereits @openrouter/ai-sdk-provider nutzt, behält das Paket. Der Verbindungs-Diff oben ist der kleinste Umstieg; vorhandene Aufrufe für generateText, streamText, Tool-Schleifen, strukturierte Ausgaben, Reasoning und Provider-Routing behalten ihren Provider.

Für eine neue Integration ist @ai-sdk/openai-compatible eine Alternative. Zusammen mit ai installieren, den Provider unten anlegen und dessen Modell an die gewohnten AI-SDK-Aufrufe übergeben. maxOutputTokens, temperature und andere unterstützte AI-SDK-Einstellungen direkt setzen. Gateway-Erweiterungen wie provider, plugins und reasoning gehören in providerOptions.tokenlane.

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

const tokenlane = createOpenAICompatible({
  name: 'tokenlane',
  baseURL: 'https://api.tokenlane.de/v1',
  apiKey: process.env.TOKENLANE_API_KEY,
  includeUsage: true,
});

Endpunkte

Basis-URL https://api.tokenlane.de/v1, mit demselben Inferenz-Key für alle Endpunkte unten. Die API-Referenz zeigt zu jedem ein ausführbares Beispiel. Eigene OpenRouter-Produkte (gehostete Agenten, Auto Router, Rankings) gibt es nicht.

EndpunktFormatUnterschiede
POST /chat/completionsOpenRouter und OpenAIStreaming, Tools, strukturierte Ausgaben, Reasoning, provider, models und plugins; Details in der Tabelle unten.
[POST /responses](https://tokenlane.de/docs/gateway/post-L3Jlc3BvbnNlcw.md?lang=de)OpenAI ResponsesZustandslos: previous_response_id liefert 400 invalid_parameter, deshalb den vollständigen Verlauf in input senden.
[POST /messages](https://tokenlane.de/docs/gateway/post-L21lc3NhZ2Vz.md?lang=de)Anthropic MessagesFür Anthropic-SDKs ANTHROPIC_BASE_URL auf den Gateway-Ursprung ohne /v1 setzen; der Key funktioniert als x-api-key oder Authorization: Bearer.
POST /embeddingsOpenRouter und OpenAIusage.cost in EUR.
[POST /rerank](https://tokenlane.de/docs/gateway/post-L3JlcmFuaw.md?lang=de)Im Stil von Cohere v2Gateway-Erweiterungen für Textobjekte und zurückgegebene Dokumente.
POST /audio/transcriptions, POST /audio/speechOpenRouterSprachausgabe standardmäßig pcm, nicht mp3.
[POST /ocr](https://tokenlane.de/docs/gateway/post-L29jcg.md?lang=de), [POST /pii/redact](https://tokenlane.de/docs/gateway/post-L3BpaS9yZWRhY3Q.md?lang=de)TokenlaneKein Gegenstück bei OpenRouter.
GET /modelsOpenRouterOhne Key. Preise in EUR; jedes Modell nennt seine routes.
GET /key, GET /generationOpenRouterBeträge in EUR, auch in Feldern mit *_usd.

Was gleich bleibt und was abweicht

ThemaGleichAnders
Modell-IDsDas Format anbieter/modell.Nur der kuratierte europäische Katalog. Unbekannte IDs, Suffixe wie :free und openrouter/auto scheitern mit 400 model_not_found.
Routingprovider (order, only, ignore, allow_fallbacks, require_parameters, max_price, sort) und models für Fallbacks.Nur europäische Anbieter. max_price gilt in EUR pro Million Tokens. sort nach Latenz oder Durchsatz nutzt die Messwerte dieses Gateways. Routing und Fallbacks
Pluginsfile-parser und response-healing verwenden die gewohnte Anfrageform.Die Verfügbarkeit hängt von der Instanz ab: web benötigt eine angebotene Suchroute und die Freigabe für web_search; pii-redact benötigt einen eingerichteten Detektor. Ohne eingerichteten Detektor liefert pii-redact 501 feature_unavailable. Wird web nicht angeboten, folgt je nach Instanzkonfiguration 400 invalid_parameter mit Issue-Code not_available. Ihre Verfügbarkeit in Production nicht voraussetzen.
ParameterAlle von OpenRouter; unbekannte werden ignoriert.Ignorierte Namen stehen im Header x-ignored-params. Der ganze Body wird vor jedem Provider-Aufruf geprüft: Probleme, die OpenRouter weiterreicht (unbekannte Rolle, kaputtes Tool-Schema, ungültige Bild-URL), scheitern sofort mit allen issues.
Fehlererror.code, message, metadata; dieselben Status.metadata.type ist stabil; request_id, issues, remedy_hint und retryable sind immer gesetzt. raw bleibt leer. Provider-Feldpfade werden bewusst nicht übernommen; ohne sichere Feldzuordnung bleibt issues[].path beim $-Fallback.
StreamingServer-Sent Events mit Abschluss data: [DONE]; spätere Fehler kommen als Fehlerereignis.Der letzte Chunk vor [DONE] enthält usage mit den Kosten in EUR.
AbrechnungPrepaid-Guthaben, usage.cost.Durchgängig EUR: usage.cost, usage.currency, Preise in /models, max_price, Key-Limits. Felder mit *_usd in GET /v1/key enthalten EUR; Budgetobjekte in budgets und effective_budget tragen ausdrücklich currency: "EUR".
KontoautomatisierungManagement-Keys.Die Verwaltungs-API auf dem Dashboard-Host unter /api, mit eigenen Pfaden und Fehlern. Authentifizierung

GET /v1/byok/import-key dient dem Key-Import über die Konsole. GET /v1/media/{token} ist ein temporärer Provider-Transport. Diese internen Hilfsendpunkte sind keine Schnittstellen für Kundencode. Die API-Referenz kennzeichnet sie entsprechend.

Bewusste Unterschiede bei Endpunkten und Verhalten

Diese OpenRouter- oder OpenAI-Endpunkte werden nicht angeboten und liefern 404 not_found:

Nicht angebotenAlternative
GET /v1/creditsGET /v1/key, mit gateway_credits für das Gateway-Guthaben.
GET /v1/providersGET /v1/models, mit routes des Modells.
GET /v1/models/{author}/{slug}/endpointsGET /v1/models, mit routes des Modells.
POST /v1/completionsPOST /v1/chat/completions mit einem messages-Array.

/api/v1 bleibt bewusst nicht unterstützt und ist kein Alias für /v1.

Für Text-to-Speech liefert POST /v1/audio/speech standardmäßig pcm, anders als OpenAI mit mp3. Wenn die Anwendung ein bestimmtes Format erwartet, response_format ausdrücklich setzen.

Eine benötigte Funktion, die dauerhaft nicht eingerichtet ist, liefert 501 feature_unavailable, retryable: false, ohne Retry-After. Eine Wiederholung derselben Anfrage kann sie nicht aktivieren. Temporäre Ausfälle bleiben davon unterschieden und behalten ihren konkreten Fehlertyp und ihre Wiederholungshinweise; nicht jeder nicht verfügbare Provider oder vorübergehende Fehler ist ein 501.

Vor der Umstellung des Verkehrs

  • [ ] Jede verwendete Modell-ID steht in GET /v1/models, ohne Suffix.
  • [ ] Plugins und Parameter aus der Tabelle sind entfernt oder ersetzt.
  • [ ] max_price und Ausgabenlimits sind EUR-Beträge.
  • [ ] Die Fehlerbehandlung liest error.metadata.type; auf ein 402 folgt eine Aufladung, keine Wiederholung.
  • [ ] Eine normale und eine Streaming-Anfrage gelingen mit plausiblem usage.cost und usage.currency EUR.
  • [ ] Automatisierung auf Basis von OpenRouter-Management-Keys nutzt die Verwaltungs-API.

Als Nächstes