OPENROUTER API
EIN KEY
400+ MODELLE.
Leitfaden: Separate API-Keys für OpenAI, Anthropic, Google und DeepSeek bedeuten fünf Dashboards, fünf Rate-Limits und eigene Failover-Logik. OpenRouter bündelt 70+ Anbieter und 400+ Modelle hinter einem OpenAI-kompatiblen Endpoint. Dieser datengetriebene Leitfaden liefert präzise Specs: Routing-Mechanismus, Vergleichstabelle vs. Direkt-API, fünf messbare Vorteile, DSGVO-relevante Ausschlusskriterien, 3-Schritt-Setup, Produktionscode (curl/Python/Node/OpenAI-SDK), Streaming und Fallback, Preismodell (5,5%-Gebühr, BYOK) sowie FAQ.
30-Sekunden-Überblick
| Definition | Unified LLM-Gateway: 70+ Anbieter, 400+ Modelle, OpenAI-kompatibles /v1 |
| Endpoint | https://openrouter.ai/api/v1/chat/completions |
| Preis | Kein Token-Aufschlag; 5,5% auf Guthabenaufladung; 25+ Gratis-Modelle |
| Gratis-Tier | 50 Anfr./Tag ohne Kauf; 1.000/Tag nach $10-Aufladung |
| Latenz-Overhead | 10–80 ms Routing vs. Direkt-API |
| DSGVO | US-Drittanbieter-Routing — AVV/BYOK/Direkt-API prüfen |
1. Was ist OpenRouter?
OpenRouter ist ein einheitliches LLM-API-Gateway. Statt sich bei OpenAI, Anthropic, Google, Meta, Mistral und DeepSeek separat zu registrieren, senden Sie alle Anfragen an einen einzigen OpenAI-kompatiblen Endpoint. OpenRouter übernimmt Authentifizierung, Provider-Auswahl, Failover und Abrechnung.
Kernspezifikationen:
- Endpoint:
https://openrouter.ai/api/v1— Drop-in-Ersatz für OpenAIs Base-URL - Auth: Ein API-Key im Header
Authorization: Bearer - Modellbenennung: Format
provider/model-id— z. B.openai/gpt-4o,anthropic/claude-sonnet-4,google/gemini-2.5-pro - Kompatibilität: curl, Python requests, Node fetch, offizielles OpenAI-SDK — nur
base_urlundmodeländern
Routing-Mechanismus
| Schicht | Funktion | Beispiel |
|---|---|---|
| Modell-Routing | Sie definieren Modell-ID; OpenRouter wählt besten verfügbaren Provider | deepseek/deepseek-chat |
| Provider-Routing | Gleiches Modell auf mehreren Hosts; Routing nach Preis, Latenz, Uptime | DeepSeek via Fireworks vs. DeepSeek direkt |
| Fallback | Automatischer Retry auf Backup-Modell bei 429/5xx | Primär Claude, Fallback GPT-4o |
| Gratis-Modelle | 25+ Modelle à $0; rate-limited nach Kontostufe | meta-llama/llama-3.3-70b-instruct:free |
2. OpenRouter vs. Direkt-API: Vergleichstabelle
| Dimension | OpenRouter | Direkt-Anbieter-API |
|---|---|---|
| API-Keys | Ein Key für alle Anbieter | Separater Key pro Anbieter |
| SDK-Änderungen | Nur base_url anpassen | Anbieter-spezifische SDKs/Endpoints |
| Modellwechsel | Modellstring in einer Zeile ändern | Neuer Account, Billing, Rate-Limits |
| Failover | Integriertes Fallback Modell/Provider | Eigene Retry-Logik erforderlich |
| Token-Preis | Anbieter-Listenpreis (kein Aufschlag) | Anbieter-Listenpreis |
| Plattformgebühr | 5,5% auf Guthabenkäufe | Keine |
| Latenz | +10–80 ms Routing-Overhead | Minimal (direkt zum Anbieter) |
| Anbieter-Features | Teilmenge (kein Assistants API, begrenztes Caching) | Voller Feature-Umfang |
| Compliance / DSGVO | US-Drittanbieter-Datenrouting; AVV prüfen | Direkter DPA/AVV mit Anbieter möglich |
| Gratis-Modelle | 25+ Modelle, gestaffelte Tageslimits | Nur anbieter-spezifische Free-Tiers |
3. Fünf messbare Gründe für OpenRouter
- Ein Key, 400+ Modelle. Prototyp mit GPT-4o, Produktion mit DeepSeek V4 Flash, Eskalation zu Claude Opus — ohne Re-Auth oder neue Billing-Accounts.
- OpenAI-SDK Drop-in. Bestehende
openai.chat.completions.create()-Codebases: zwei Zeilen ändern (base_url,model). - Integriertes Failover. Agent-Loops triggern 429s ständig. Provider-Routing und Modell-Fallback reduzieren Custom-Retry-Code von Hunderten Zeilen auf einen JSON-Block.
- Echte Nutzungsdaten. OpenRouter publiziert wöchentliche Token- und Dollar-Rankings — Produktionsgrundlage statt Benchmark-Rauschen. Siehe unseren Juni-2026-Rankings-Bericht.
- Gratis-Tier zum Validieren. 25+ kostenlose Modelle, 50 Anfragen/Tag (1.000/Tag nach $10-Aufladung) — Agent-Workflows testen vor Paid-Inference.
4. Wann OpenRouter nicht nutzen
OpenRouter ist nicht immer optimal. Gateway überspringen bei:
- Latenz-kritischen Echtzeit-Apps: 10–80 ms Overhead relevant für Voice, Live-Coding, TTFT <100 ms.
- Sehr hohem Token-Volumen: Bei Millionen Tokens/Tag summiert sich 5,5% auf Guthaben. Direktverträge oder Reserved Capacity günstiger.
- Strikter DSGVO-Compliance: Personenbezogene Daten ohne dokumentierten AVV, Art.-28-Auftragsverarbeitung oder bei Verbot von US-Drittanbieter-Routing — Direkt-API oder BYOK mit EU-DPA.
- Anbieter-spezifischen Features: OpenAI Assistants, Anthropic Prompt Caching mit garantierten Hit-Rates, Google Vertex Grounding — natives SDK erforderlich.
5. Schritt-für-Schritt: OpenRouter API-Key
Schritt 1 — Registrierung
Auf openrouter.ai anmelden (Google, GitHub oder E-Mail). Keine Kreditkarte für Gratis-Modelle nötig.
Schritt 2 — API-Key erstellen
Dashboard → Keys → Create Key, benennen (z. B. prod-agent), Key sofort kopieren. In Umgebungsvariable speichern — nie in Git committen.
Schritt 3 — Erste Anfrage
Key mit minimalem curl-Aufruf verifizieren. Erwartete Antwort: JSON mit choices[0].message.content.
6. Code-Beispiele
6.1 curl
6.2 Python (requests)
6.3 Python (OpenAI-SDK Drop-in)
6.4 Node.js (OpenAI-SDK)
6.5 Streaming
6.6 Fallback-Konfiguration
Das models-Array instruiert OpenRouter, Modelle der Reihe nach zu versuchen, wenn das vorherige einen Fehler oder Rate-Limit zurückgibt. Einfachstes produktionsreifes Failover-Muster für Agent-Loops.
6.7 Verfügbare Modelle auflisten
7. Streaming, Fallback und Kostenkontrolle
Streaming: "stream": true im Request-Body. OpenRouter liefert SSE-Chunks im OpenAI-Format. Für Chat-UIs und Agent-Tool-Call-Loops, wo Time-to-First-Token zählt.
Fallback: models-Array für Modell-Failover. Für Provider-Routing wählt OpenRouter günstigsten/schnellsten Provider, sofern nicht im Dashboard via provider-Präferenzen gepinnt.
Kostenkontrolle: Ausgabenlimits im Dashboard setzen. Günstigere Modelle (DeepSeek V4 Flash, Gemini Flash) für Entwürfe; Claude Opus/GPT-4o für Eskalation. Wöchentliche Ausgaben im Activity-Tab monitoren.
8. Preise: Gratis-Tier, 5,5%-Gebühr und BYOK
| Stufe | Details |
|---|---|
| Gratis-Modelle | 25+ Modelle à $0/Token; 50 Anfragen/Tag ohne Kauf; 1.000/Tag nach $10-Aufladung |
| Kostenpflichtige Modelle | Anbieter-Listenpreis, kein per-Token-Aufschlag |
| Plattformgebühr | 5,5% auf Guthabenkäufe (nicht auf Token-Nutzung selbst) |
| BYOK | Eigener Anbieter-Key; 1 Mio. kostenlose geroutete Anfragen/Monat, danach geringe Überziehungsgebühr |
Beispiel: $100 Guthabenkauf kostet $105,50 gesamt. Die $100 kaufen Tokens zu Anbieterpreisen. Bei 10 Mio. Tokens/Tag wird 5,5% material — Direktverträge evaluieren.
9. DSGVO-Checkliste für EU-Teams
| Punkt | Prüffrage | Empfehlung |
|---|---|---|
| Art. 28 DSGVO | AVV mit OpenRouter vorhanden? | Vertrag prüfen; Subprozessor-Liste dokumentieren |
| Art. 44–49 | Drittlandtransfer USA? | TIA durchführen; BYOK oder EU-Direkt-API bei sensiblen Daten |
| Gratis-Modelle | Stealth-Modelle loggen Prompts? | Keine personenbezogenen Daten in Owl/Nemotron free |
| Produktion | Gateway als Single Point of Failure? | Fallback-Array + Spend-Caps + Audit-Log |
10. FAQ
F: Ist OpenRouter kostenlos?
A: 25+ Gratis-Modelle, 50 Anfragen/Tag ohne Aufladung. Nach $10-Guthaben: 1.000/Tag. Kostenpflichtige Modelle zum Anbieter-Listenpreis.
F: Schlägt OpenRouter Token-Preise auf?
A: Kein per-Token-Aufschlag. 5,5% nur auf Guthabenaufladungen. BYOK: 1 Mio. kostenlose geroutete Anfragen/Monat.
F: Ist OpenRouter DSGVO-konform?
A: US-Drittanbieter-Gateway. Für personenbezogene Daten: AVV prüfen, BYOK oder Direkt-API mit EU-DPA wählen, Datenfluss dokumentieren.
F: Unterschied zu OpenAI-API?
A: OpenRouter = Multi-Provider-Gateway, ein Endpoint, 400+ Modelle. OpenAI-API = nur OpenAI-Modelle mit vollem Feature-Zugang.
F: OpenAI Python SDK nutzbar?
A: Ja. base_url="https://openrouter.ai/api/v1" und OpenRouter-Key — keine weiteren Code-Änderungen.
F: Wann OpenRouter überspringen?
A: Sub-10ms-Latenz, sehr hohes Volumen (5,5%-Gebühr), strikte DSGVO/HIPAA, Anbieter-Features wie Assistants API.
11. Abschluss: OpenRouter-Dev auf Mac — Agent-Stresstests auf Remote-Knoten
OpenRouter-Integration läuft auf jedem OS. Wer Cursor + Claude Code + OpenClaw mit Multi-Modell-Fallback-Ketten betreibt, belastet den primären Mac: Docker-Sandboxen, Agent-Loops und Long-Context-Batches konkurrieren um Unified Memory.
Pragmatische Aufteilung: Cursor-Review und leichte API-Calls auf dem Laptop; Agent-Stresstests, OpenRouter-Routing-Probes und 24/7-Gateway-Cron-Jobs auf einen MACGPU Remote Mac mini M4-Knoten auslagern. SSH-Isolation, On-Demand-Miete, MLX-Validierung nebenbei.