# 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](https://tokenlane.de/docs/guides/quickstart.md?lang=de), 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

```diff
-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

```diff
 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

```diff
 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

```diff
 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`.

```ts
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](https://tokenlane.de/docs/guides/routing-and-fallbacks.md?lang=de) |
| 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](https://tokenlane.de/docs/guides/authentication.md?lang=de) |

`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_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

- [Datenschutz und Compliance](https://tokenlane.de/docs/guides/privacy-and-compliance.md?lang=de): Datenklassen je Route
- [Fehler und Wiederholung](https://tokenlane.de/docs/guides/errors-and-retries.md?lang=de): was einen erneuten Versuch verdient