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.
| Endpunkt | Format | Unterschiede |
|---|---|---|
POST /chat/completions | OpenRouter und OpenAI | Streaming, 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 Responses | Zustandslos: 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 Messages | Für Anthropic-SDKs ANTHROPIC_BASE_URL auf den Gateway-Ursprung ohne /v1 setzen; der Key funktioniert als x-api-key oder Authorization: Bearer. |
POST /embeddings | OpenRouter und OpenAI | usage.cost in EUR. |
[POST /rerank](https://tokenlane.de/docs/gateway/post-L3JlcmFuaw.md?lang=de) | Im Stil von Cohere v2 | Gateway-Erweiterungen für Textobjekte und zurückgegebene Dokumente. |
POST /audio/transcriptions, POST /audio/speech | OpenRouter | Sprachausgabe 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) | Tokenlane | Kein Gegenstück bei OpenRouter. |
GET /models | OpenRouter | Ohne Key. Preise in EUR; jedes Modell nennt seine routes. |
GET /key, GET /generation | OpenRouter | Beträge in EUR, auch in Feldern mit *_usd. |
Was gleich bleibt und was abweicht
| Thema | Gleich | Anders |
|---|---|---|
| Modell-IDs | Das Format anbieter/modell. | Nur der kuratierte europäische Katalog. Unbekannte IDs, Suffixe wie :free und openrouter/auto scheitern mit 400 model_not_found. |
| Routing | provider (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 |
| Plugins | file-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. |
| Parameter | Alle 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. |
| Fehler | error.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. |
| Streaming | Server-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. |
| Abrechnung | Prepaid-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". |
| Kontoautomatisierung | Management-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 angeboten | Alternative |
|---|---|
GET /v1/credits | GET /v1/key, mit gateway_credits für das Gateway-Guthaben. |
GET /v1/providers | GET /v1/models, mit routes des Modells. |
GET /v1/models/{author}/{slug}/endpoints | GET /v1/models, mit routes des Modells. |
POST /v1/completions | POST /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_priceund 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.costundusage.currencyEUR. - [ ] Automatisierung auf Basis von OpenRouter-Management-Keys nutzt die Verwaltungs-API.
Als Nächstes
- Datenschutz und Compliance: Datenklassen je Route
- Fehler und Wiederholung: was einen erneuten Versuch verdient