Ein Key · 400+ Modelle · Routing-Ebenen · Sechs-Schritte-Setup · curl/Python/Node · Streaming & Fallback · BYOK-Preise
Wenn Sie separate API-Keys für OpenAI, Anthropic und Google verwalten — jeweils mit unterschiedlichen SDKs, Rate Limits und Billing-Dashboards — bündelt OpenRouter diesen Overhead in einem einzigen OpenAI-kompatiblen Endpunkt. Dieser Leitfaden 2026 erklärt, was OpenRouter unter der Haube leistet, führt durch ein Sechs-Schritte-API-Key-Setup, liefert Copy-Paste-Beispiele in curl, Python, Node.js und dem OpenAI SDK (inkl. Streaming und Fallback), vergleicht OpenRouter vs. direkte Vendor-APIs, behandelt Preise, BYOK und Free-Tier-Modelle und schließt mit einer SEO-Checkliste für den deutschen Markt plus dem Grund, warum lang laufende Agents weiterhin auf einer 24/7 Mac Mini M4 Miete gehören.
OpenRouter ist ein einheitliches LLM-Gateway: ein API-Key, eine Base-URL und Zugriff auf 400+ Modelle von OpenAI, Anthropic, Google, Meta, DeepSeek, Mistral, xAI und Dutzenden Open-Weight-Anbietern. Es spricht das OpenAI Chat Completions API-Format — die meiste bestehende Codebasis funktioniert nach Änderung von zwei Zeilen: base_url und model.
Stellen Sie sich OpenRouter als intelligenten Proxy zwischen Ihrer Anwendung und Upstream-Inference-Anbietern vor. Bei jeder Anfrage entscheiden drei Routing-Ebenen, wohin sie geht und was bei Ausfall passiert.
Sie geben eine Modell-ID im Request-Body an — z. B. anthropic/claude-sonnet-4, openai/gpt-5 oder google/gemini-2.5-pro-preview. OpenRouter pflegt einen Live-Katalog unter openrouter.ai/models mit Preisen pro Modell, Context-Limits und Modalitäten (Text, Vision, Tools).
Viele Modelle haben mehrere Upstream-Provider — dasselbe meta-llama/llama-3.3-70b-instruct kann von Together, Fireworks oder DeepInfra bedient werden. OpenRouter wählt den besten verfügbaren Provider nach Latenz, Preisstufe und Kapazität. Überschreiben können Sie das mit dem Feld provider oder per BYOK (Bring Your Own Key), um direkt über Ihr Vendor-Konto abzurechnen.
Liefert ein Provider 429, 502 oder Timeout, kann OpenRouter automatisch auf einen alternativen Provider retryen oder auf ein von Ihnen definiertes Sekundärmodell fallen. Das macht aus einer brüchigen Single-Vendor-Integration produktionsreife Infrastruktur — besonders für Agent-Workloads, die mitten in der Aufgabe nicht hart stoppen dürfen.
OpenRouter trainiert standardmäßig nicht auf Ihrem API-Traffic. Für regulierte Workloads BYOK-Routing mit Ausgabenlimits und Key-Rotation kombinieren — dieselbe Hygiene wie bei jedem direkten Vendor-Key.
OpenRouter veröffentlicht Live-Nutzungsrankings unter openrouter.ai/rankings, die zeigen, welche Modelle Entwickler in Produktion wirklich nutzen. Ergänzend zu diesem API-Leitfaden siehe unseren Juni-2026-Rankings-Artikel für Volumen-vs.-Qualitäts-Analyse.
base_url auf https://openrouter.ai/api/v1 setzen und Modellstring tauschen. Viele LangChain-, Cursor- und OpenClaw-Konfigurationen brauchen null Refactor.| Dimension | OpenRouter | Direkte Vendor-API |
|---|---|---|
| Benötigte API-Keys | Ein OpenRouter-Key (oder BYOK pro Vendor) | Ein Key pro Vendor (OpenAI, Anthropic, Google usw.) |
| SDK-Kompatibilität | OpenAI Chat Completions Format (universal) | Vendor-spezifische SDKs und Endpunktformen |
| Modellwechsel | model-Feld in einer Anfrage ändern | Neues SDK-Init, neues Billing-Konto, neue Rate Limits |
| Fallback bei 429/502 | Integriertes Provider-Retry und Modell-Fallback-Ketten | Custom-Retry-Logik pro Vendor |
| Preise | Gelistete Modelltarife; BYOK vermeidet Aufschlag | Vendor-Listenpreis; Enterprise-Rabatte über Sales |
| Free-Modelle | Owl Alpha, Nemotron 3 Super und andere zu 0 $ | Begrenzte Free-Tiers pro Vendor (Gemini free, Claude trial) |
| Latenz-Overhead | ~20–80 ms Proxy-Hop (je nach Region) | Direkt zum Vendor-Edge; minimal möglich |
| Observability | Einheitliches Dashboard: Ausgaben, Tokens, Modell-Mix | Separate Dashboards pro Vendor |
| Am besten für | Multi-Model-Agents, Startups, Kostenoptimierung | Single-Vendor-Enterprise, native Feature-Bedürfnisse |
Dieses Runbook führt in unter fünfzehn Minuten von der Kontoerstellung zum verifizierten Produktionsaufruf. Jeden Schritt abschließen, bevor OpenRouter in einen Agent-Daemon oder CI-Pipeline eingebunden wird.
Konto anlegen: Gehen Sie zu openrouter.ai und registrieren Sie sich per E-Mail oder GitHub. Neue Konten erhalten Startguthaben — genug für Dutzende Sonnet-Aufrufe oder Tausende Flash-Tier-Tokens.
API-Key erzeugen: Unter Keys im Dashboard einen Key mit sprechendem Namen anlegen (z. B. prod-agent-v1). Sofort kopieren — OpenRouter zeigt den vollständigen Key nur einmal.
Ausgabenlimit setzen: Unter Settings monatliches Budget und E-Mail-Alerts bei 50 %, 80 % und 100 % konfigurieren. Für Agent-Workloads mit $50/Monat starten und nach Token-Verbrauch skalieren.
Key sicher speichern: Niemals Keys in Git committen. Umgebungsvariablen (OPENROUTER_API_KEY), macOS Keychain oder CI-Secret-Store nutzen. Keys in Produktion monatlich rotieren.
Mit curl verifizieren: Das curl-Beispiel in Abschnitt 04 ausführen. Eine 200-Antwort mit choices[0].message.content bestätigt Key, Routing und Modell-ID.
In den Stack einbinden: OpenAI SDK, LangChain oder Agent-Framework auf https://openrouter.ai/api/v1 zeigen. HTTP-Referer und X-Title Header setzen für OpenRouter-Analytics. Daemon auf einem Host deployen, der wach bleibt — siehe Abschnitt 06 für Mac-Mini-Hinweise.
Sicherheitshinweis: OpenRouter-Keys wie Produktions-Datenbank-Credentials behandeln. Bei Leak sofort im Dashboard widerrufen und Ausgaben prüfen. OpenRouter unterstützt pro-Key Rate Limits — für öffentliche Endpunkte nutzen.
Alle Beispiele nutzen denselben Endpunkt: https://openrouter.ai/api/v1/chat/completions. YOUR_KEY durch Ihren API-Key ersetzen und ein Modell aus dem Katalog wählen.
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-H "HTTP-Referer: https://your-app.com" \
-H "X-Title: Your App Name" \
-d '{
"model": "anthropic/claude-sonnet-4",
"messages": [{"role": "user", "content": "Explain OpenRouter in one sentence."}]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="YOUR_KEY",
)
response = client.chat.completions.create(
model="deepseek/deepseek-chat-v3-0324",
messages=[{"role": "user", "content": "Write a Python hello world."}],
extra_headers={
"HTTP-Referer": "https://your-app.com",
"X-Title": "Your App Name",
},
)
print(response.choices[0].message.content)
const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
"Content-Type": "application/json",
"HTTP-Referer": "https://your-app.com",
"X-Title": "Your App Name",
},
body: JSON.stringify({
model: "google/gemini-2.5-pro-preview",
messages: [{ role: "user", content: "Summarize REST vs GraphQL." }],
}),
});
const data = await res.json();
console.log(data.choices[0].message.content);
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="YOUR_KEY",
)
response = client.chat.completions.create(
model="openai/gpt-5",
messages=[{"role": "user", "content": "Compare GPT-5 and Claude Sonnet 4."}],
tools=[{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}],
)
print(response.choices[0].message)
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="YOUR_KEY",
)
stream = client.chat.completions.create(
model="anthropic/claude-sonnet-4",
messages=[{"role": "user", "content": "Stream this response token by token."}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)
{
"model": "anthropic/claude-sonnet-4",
"models": [
"anthropic/claude-sonnet-4",
"deepseek/deepseek-chat-v3-0324",
"google/gemini-2.5-flash-preview"
],
"messages": [{"role": "user", "content": "Handle this with automatic fallback."}],
"route": "fallback"
}
Mit models-Array und "route": "fallback" versucht OpenRouter jedes Modell der Reihe nach, bis eines erfolgreich ist. Einfachstes Produktionsmuster für Agent-Pipelines ohne Single Point of Failure. Für Gateway-Routing mit Budget-Caps siehe unseren OpenClaw Multi-Model-Routing-Leitfaden.
curl https://openrouter.ai/api/v1/models \
-H "Authorization: Bearer $OPENROUTER_API_KEY" | jq '.data[] | {id, pricing}'
Der Models-Endpunkt liefert jedes verfügbare Modell mit Preisen, Context-Länge und Modalitäten. Antwort in der App cachen und täglich aktualisieren — mid-2026 erscheinen wöchentlich neue Modelle.
OpenRouter berechnet pro Token zum für jedes Modell gelisteten Satz. Keine monatliche Plattformgebühr. Standard-Routen leiten Upstream-Listenpreise weiter — OpenRouter addiert keinen versteckten Aufschlag. Sie zahlen nur verbrauchte Tokens.
| Modell (Juli 2026) | Input $/M | Output $/M | Context | Hinweise |
|---|---|---|---|---|
| DeepSeek V4 Flash | ~0.10 | ~0.40 | 1M | Bestes Preis-Leistungs-Verhältnis für hochfrequentes Coding |
| Claude Sonnet 4 | 3.00 | 15.00 | 200K | Ausgewogener Produktions-Default |
| Claude Opus 4 | 15.00 | 75.00 | 200K | Lang-Horizont-Agents, schwierigstes Reasoning |
| GPT-5 | 5.00 | 15.00 | 128K | Starkes Tool Calling und Ökosystem |
| Gemini 2.5 Pro | 1.25 | 10.00 | 1M+ | Multimodal, langer Context |
| Owl Alpha | 0.00 | 0.00 | 1.05M | Free Tier; keine Secrets senden |
BYOK verbindet Ihre bestehenden OpenAI-, Anthropic- oder Google-API-Keys mit OpenRouter. Anfragen laufen über OpenRouter-Infrastruktur, Rechnung geht direkt an Ihr Vendor-Konto. OpenRouter erhebt eine kleine Plattformgebühr (typisch 5 % des Upstream-Kostens) für Routing, Observability und Fallback. Ideal, wenn Sie Enterprise-Pricing beim Vendor haben, aber einheitliches Routing über mehrere Provider wollen.
OpenRouter hostet mehrere Modelle zum Listenpreis 0 $ — u. a. Owl Alpha und Nemotron 3 Super. Neue Konten erhalten Startguthaben. Free-Modelle eignen sich für Prototypen und Draft-Agent-Tasks, können aber Prompts für Modellverbesserung loggen. Regulierte Daten, Kunden-PII oder Produktions-Secrets niemals über Free-Tier-Modelle leiten.
VpsMesh veröffentlicht in acht Sprachen. Deutsche Seiten performen oft schlechter als chinesische Gegenstücke beim Roh-Traffic — dennoch sind sie wichtig für lokale Auffindbarkeit, Backlink-Equity und Entwickler-Vertrauen. Wenn Ihre deutschen Blogposts in der Google Search Console wenig Impressionen zeigen, prüfen Sie diese Checkliste, bevor Sie die Content-Qualität infrage stellen.
Google Search Console: Die /de/-Property separat verifizieren. Coverage auf Crawl-Fehler prüfen, URL-Inspection auf Canonical-Mismatch, Performance gefiltert auf /de/blog/. Wenig Impressionen bei null Klicks bedeuten oft Indexierungs-Lag, nicht schlechten Content.
hreflang-Tags: Jeder deutsche Artikel braucht wechselseitige hreflang-Links zu zh, ja, ko, en, fr, ru und zh-Hant. Fehlende oder einseitige hreflang ist der häufigste Grund, warum Google die chinesische URL für deutsche Queries ausliefert.
CDN- und WAF-Tuning: Sicherstellen, dass Cloudflare oder Ihr CDN EU-Crawler nicht geo-blockt oder challenge-captcha blockiert. Aggressiver Bot Fight Mode kann Googlebot auf neuen /de/-Pfaden still droppen.
Lokalisierung, nicht Übersetzung: Deutsche Seiten müssen native Rewrites mit DE-Suchintent sein — „OpenRouter API Tutorial“ statt wörtlicher Übersetzung chinesischer Keyword-Cluster. Title-Tags, H2s und FAQ-Fragen müssen zur tatsächlichen DE-Entwicklersuche passen.
Interne Verlinkung vom DE-Hub: Neue DE-Posts von /de/blog/index.html und mindestens zwei verwandten DE-Artikeln verlinken. Waisen-Seiten in einer Nischen-Locale ranken selten.
Structured Data: BlogPosting und FAQPage JSON-LD auf jedem Artikel. FAQ-Schema treibt Rich Results für Long-Tail wie „Ist OpenRouter kostenlos“ und „OpenRouter vs direkte API“.
Praktischer Tipp: Nach der Veröffentlichung die deutsche URL über GSC URL Inspection einreichen und Indexierung anfordern. Kombinieren Sie das mit einem kontextuellen Backlink aus einem verwandten DE-Post — interne Link-Equity zählt mehr als Keyword-Dichte für neue /de/-Pfade.
OpenRouter löst das Inference-Vendor-Problem — ein Key, Fallback-Ketten, vereinheitlichte Abrechnung. Es löst nicht das Host-Uptime-Problem. Agent-Daemons, die OpenRouter alle paar Minuten aufrufen, brauchen eine Maschine, die nie schläft, Secrets in Keychain hält und macOS-native Tools wie Claude Code, Xcode und OpenClaw ohne Linux-Kompatibilitäts-Hacks ausführt.
Produktionsmuster: Entwickler binden OpenRouter an einem Nachmittag ein, verlieren dann nächtliche Agent-Runs, wenn der Laptop zugeklappt wird oder eine Free-Tier-Cloud-VM preempted wird. Linux-VPS funktioniert für reine API-Skripte ohne macOS-Abhängigkeit. Stacks mit Claude Code + OpenClaw + iOS CI zahlen auf Linux doppelte Integrationssteuer — Metal-Lücken, Keychain-Workarounds und fehlendes Xcode bedeuten Wochen Glue Code.
VpsMesh Mac Mini M4 Cloud-Miete bündelt 24/7-Uptime, Remote-KVM, launchd-Daemon-Supervision und native macOS-Pfade in planbare monatliche OpEx. OpenRouter-Config auf die Miete zeigen, Keys in Keychain, Agents laufen lassen während Sie Diffs lokal reviewen. Ein Monat reicht, um Routing zu validieren, Token-Burn zu messen und Daemon-Stabilität zu prüfen.
Siehe Mac Mini M4 Mietpreise für Planvergleich und Hilfezentrum für Deployment-Schritte, SSH-Setup und Daemon-Härtung. Für Multi-Model-Gateway-Muster auf demselben Host: unseren OpenClaw-Routing-Leitfaden und Persistent-Agent-Setup.
OpenRouter erhebt keine monatliche Plattformgebühr. Sie zahlen pro Token zu den gelisteten Modelltarifen oder 0 $ bei Free-Tier-Modellen wie Owl Alpha. Neue Konten erhalten Startguthaben zum Testen. Produktions-Agent-Workloads sollten bezahlte Routen mit Budget-Obergrenzen im Dashboard nutzen.
Bei Standard-Routen leitet OpenRouter die Upstream-Listenpreise ohne versteckten Aufschlag weiter. BYOK-Routen stellen direkt beim Anbieter in Rechnung; OpenRouter erhebt eine kleine Plattformgebühr (typisch ~5 %) für Routing und Observability. Vergleichen Sie Tarife unter openrouter.ai/models.
Lohnt sich bei Multi-Vendor-Zugriff, automatischem Fallback, vereinheitlichter Abrechnung oder OpenAI-SDK-Drop-in. Besser nicht bei Single-Vendor-Enterprise-Vertrag, provider-nativen Features (Assistants, Prompt Caching) oder Inference in einer bestimmten Cloud-Region ohne Proxy-Hops.
400+ Modelle von OpenAI, Anthropic, Google, Meta, DeepSeek, Mistral, xAI und anderen. Nutzen Sie GET /api/v1/models oder den Katalog unter openrouter.ai/models. Modell-IDs folgen vendor/model-name — z. B. anthropic/claude-sonnet-4, openai/gpt-5, google/gemini-2.5-pro-preview.
OpenRouter ist SOC 2 Type II zertifiziert und trainiert standardmäßig nicht auf API-Traffic. Regulierte Daten über BYOK oder selbst gehostete Open-Modelle leiten. Keys monatlich rotieren, pro-Key-Rate-Limits setzen und niemals Secrets in Git committen. Free-Tier-Modelle können Prompts loggen — Produktions-Secrets nur über bezahlte Routen.
Installieren Sie das openai-Paket, setzen Sie base_url="https://openrouter.ai/api/v1" und api_key auf Ihren OpenRouter-Key. Übergeben Sie eine unterstützte Modell-ID im model-Feld. Fügen Sie HTTP-Referer und X-Title über extra_headers hinzu. Vollständiges Beispiel in Abschnitt 04 oben.