Ist OpenRouter mit der OpenAI API kompatibel?

Ja. Mit base_url https://openrouter.ai/api/v1 funktionieren OpenAI SDK, LangChain und Cursor unverändert. Nur die model-ID im Format vendor/model (z. B. anthropic/claude-sonnet-4) anpassen.

Wie hoch sind die Free-Model-Limits?

Über 25 kostenlose Modelle: 50 Aufrufe/Tag ohne Guthaben, 1.000 Aufrufe/Tag nach Aufladung ab 10 USD. Kostenpflichtige Modelle ohne Token-Aufschlag; 5,5 % Gebühr nur auf Credit-Aufladungen.

Wann sollte man OpenRouter nicht nutzen?

Bei Latenzbudget unter 10 ms (Realtime-Sprache), monatlich Milliarden Token mit Enterprise-Direktvertrag, strikten Data-Residency-Vorgaben oder wenn OpenAI Realtime, Anthropic Computer Use oder Vertex-exklusive Features nötig sind.

Wo OpenRouter-Agenten 24/7 betreiben?

CLI-Agenten wie Hermes, Kilo Code und Claude Code benötigen macOS Seatbelt, Keychain und stabile Long-Lived-Sessions. Dedizierte NUKCLOUD Cloud-Mac-Knoten reduzieren NAT-Timeouts und Audit-Lücken gegenüber überbuchten Linux-VPS.

OpenRouter API: GPT, Claude und Gemini mit einem Key anbinden (Leitfaden 2026)

Q: Model Routing vs. Provider Routing?

Model Routing wählt automatisch den günstigsten verfügbaren Anbieter für eine Modell-ID. Provider Routing setzt provider.order im Request und erzwingt eine Anbieter-Priorität für Compliance oder SLA.

Teams mit getrennten OpenAI-, Anthropic- und Google-Rechnungen verlieren Zeit an SDK-Forks und manuelle Failover. OpenRouter reduziert das auf einen API-Key und vendor/model-IDs. Dieser Artikel deckt ab: Gateway-Definition, Model vs. Provider Routing, fünf Vorteile plus Gegenindikationen, curl/Python/Node/Streaming/Fallback-Code, Sechs-Schritte-Key-Setup, Traffic- und SEO-Diagnose, Distributions-Prioritäten sowie die Kopplung an CLI-Rankings und LLM-Trends auf NUKCLOUD Cloud-Mac-Hosts.

00Was ist OpenRouter?

OpenRouter ist ein neutraler LLM-Gateway: Chat-Completions-JSON wie bei OpenAI, Modellauswahl über model: "vendor/model" (z. B. openai/gpt-5.6-sol, anthropic/claude-sonnet-4, google/gemini-2.5-pro). Der Router wählt den Inference-Host. Plattform-Traffic liegt bei rund 100 Billionen Token/Monat; laut Juni-2026-Ranking dominieren DeepSeek, Claude und Gemini die Top-Listen.

Primärer Endpoint: POST https://openrouter.ai/api/v1/chat/completions. Modellkatalog: GET https://openrouter.ai/api/v1/models. Auth: Authorization: Bearer <OPENROUTER_API_KEY>. Optional: HTTP-Referer und X-Title für App-Rankings. OpenAI SDK: base_url="https://openrouter.ai/api/v1".

Datenpunkt 1: 70+ Provider, 400+ Modell-IDs (Katalog Juli 2026).
Datenpunkt 2: 0 % Token-Markup; 5,5 % nur auf Credit-Aufladungen.
Datenpunkt 3: BYOK: 1.000.000 Requests/Monat kostenfrei geroutet, Token direkt beim Anbieter abgerechnet.

痛点Mehrere Vendor-APIs direkt: versteckte Kosten

Adapter-Schichten: Unterschiedliche Header, Streaming und Tool-Schemas pro Anbieter vervielfachen Agent-Framework-Code.
Failover-Lücken: Manuelles Umschalten der Modell-ID stoppt CI, Bots und IDE-Skills gleichzeitig. OpenRouter-models-Arrays versuchen Fallbacks in einem Request.
Fragmentierte Abrechnung: Finanzteams mergen CSVs aus GPT-, Claude- und DeepSeek-Portalen. OpenRouter konsolidiert Token und USD pro Modell, App und Projekt.
Instabile Agent-Hosts: Hermes und Claude Code benötigen macOS Seatbelt und stabile TCP-Sessions. Billige Linux-VPS mit Overselling und NAT brechen Long-Lived-Verbindungen häufiger.

01Model Routing vs. Provider Routing

Dimension	Model Routing (Standard)	Provider Routing (explizit)
Auswahl	Automatisch: Preis, Latenz, Verfügbarkeit	`provider.order` im Request-Header/Body
Use Case	Kosten, Experimente, Multi-Fallback	Region, Vertrag, Data Residency
Latenz-Overhead	10–80 ms zusätzlicher Hop	Gleich; falsche Order erhöht 429/503
Fallback	`models: ["a","b","c"]`, `route: "fallback"`	Order-Kette oder models-Fallback
Abrechnung	Anbieter-Tokenpreis + 5,5 % Credit-Gebühr	BYOK: Direktabrechnung beim Vendor

Produktion: Model Routing + models-Fallback als Default. Provider Routing nur bei Compliance-Pflicht. Empfohlen: provider: { allow_fallbacks: true }.

02Fünf Vorteile und Gegenindikationen

Vorteil	Spezifikation
Ein Key, ein SDK	OpenAI-kompatibel für GPT, Claude, Gemini, DeepSeek
Transparente Preise	Kein Token-Markup; 5,5 % nur auf Aufladung
Free Tier	25+ Free-Modelle; 50/Tag ohne Guthaben, 1.000/Tag ab 10 USD
Observability	Öffentliche App-Token-Rankings für CLI-Benchmarks
BYOK	Eigene OpenAI/Anthropic-Keys; 1 Mio. req/Monat frei

Gegenindikation	Schwellwert / Grund
Ultra-niedrige Latenz	< 10 ms Budget (Realtime, Gaming)
Extremes Volumen	Milliarden Token/Monat → Enterprise-Direktvertrag günstiger
Compliance	Daten dürfen Gateway-US nicht passieren (Audit erforderlich)
Vendor-exklusive APIs	OpenAI Realtime, Anthropic Computer Use, Vertex-only

03API-Key, Header, Preisparameter

Keys unter openrouter.ai/keys erstellen; prod/dev trennen, Spending Limits setzen. Pflichtheader: Authorization. Tracking: HTTP-Referer, X-Title.

Parameter	Wert
Endpoint	`https://openrouter.ai/api/v1/chat/completions`
Modell-ID	`vendor/model`
Token-Markup	0 %
Credit-Gebühr	5,5 % auf Aufladungen
Free-Modelle	25+; 50/Tag → 1.000/Tag nach 10 USD
BYOK-Limit	1.000.000 req/Monat
Routing-Latenz	10–80 ms typisch

Host-Kosten getrennt erfassen: API-Token laut OpenRouter-Dashboard; Mac-Agent-Hosts laut NUKCLOUD-Preise.

04Code: curl, Python, Node, Streaming, Fallback

curl — chat completion

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://nukcloud.com" \
  -H "X-Title: NUKCLOUD Agent" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "messages": [{"role": "user", "content": "Swift 6 Sendable checklist"}]
  }'

Python — requests

import os, requests
r = requests.post(
    "https://openrouter.ai/api/v1/chat/completions",
    headers={"Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}"},
    json={
        "model": "google/gemini-2.5-pro",
        "messages": [{"role": "user", "content": "Zusammenfassen"}],
    },
    timeout=60,
)
print(r.json()["choices"][0]["message"]["content"])

Python — OpenAI SDK

from openai import OpenAI
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)
resp = client.chat.completions.create(
    model="openai/gpt-5.6-sol",
    messages=[{"role": "user", "content": "Hello"}],
)

Node — OpenAI SDK

import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});
const out = await client.chat.completions.create({
  model: "deepseek/deepseek-v4-flash",
  messages: [{ role: "user", content: "Antwort auf Deutsch" }],
});

JavaScript — SSE streaming

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",
  },
  body: JSON.stringify({
    model: "anthropic/claude-sonnet-4",
    stream: true,
    messages: [{ role: "user", content: "Stream test" }],
  }),
});

JSON — models fallback

{
  "models": [
    "anthropic/claude-sonnet-4",
    "openai/gpt-5.6-sol",
    "google/gemini-2.5-flash"
  ],
  "route": "fallback",
  "messages": [{"role": "user", "content": "Auto failover"}]
}

curl — model list

curl https://openrouter.ai/api/v1/models \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" | jq '.data[:3]'

05Erweitert: Provider order, Free Models, BYOK

"provider": { "order": ["Anthropic", "Amazon Bedrock"] } erzwingt Anbieter-Priorität. BYOK: Keys im Dashboard hinterlegen; OpenRouter routet bis 1 Mio. req/Monat gratis, Token beim Vendor. Free-Modelle (z. B. meta-llama/llama-3.3-70b-instruct:free) für Prototypen; Produktion mit Paid + Fallback + Alerts.

06Traffic-Diagnose bei niedrigen EN/DE-Impressionen

Google Search Console: Indexierung, CTR, Queries wie „OpenRouter API“, „GPT Claude Gemini one key“.
CDN/WAF: Kein Block für Googlebot/Bingbot.
hreflang: Nur auf Blog-Index; Detailseiten: single canonical, kein hreflang (Projektregel).
Machine Translation: Identische Satzstruktur DE/EN schwächt EEAT; lokale Neuschreibung.
Backlinks: GitHub Gist, Dev.to, Hacker News Show mit Messdaten.

07SEO-Keyword-Matrix und Meta-Signale

Signal	Deutsch (de)	Englisch (en)
Primary KW	OpenRouter API, GPT Claude Gemini anbinden	OpenRouter API, GPT Claude Gemini one key
Title	Jahr + Leitfaden + Anbieterliste	How to Use OpenRouter API + (2026 Guide)
Meta	120–160 Zeichen, Code + FAQ-Versprechen	120–160 chars, routing + BYOK
Localization	Spec-Tabellen, EUR/USD, DSGVO-Hinweis	Kurze Sätze, compliance section

Lokalisierung ≠ Übersetzung: slug, id und date bleiben identisch; title, intro, tags und Body werden pro Sprache neu geschrieben.

08Technisches SEO: URL, canonical, Schema

URL-Muster: https://nukcloud.com/{lang}/blog/{slug}.html
Canonical: self-referencing auf Detailseiten
Sitemap: nach Deploy generate-sitemap.js ausführen
Schema: BlogPosting + FAQPage in mainEntity (diese Seite)
Open Graph: og:type=article, og:url=canonical

09Distribution, P0/P1/P2, Metriken

Kanal	Format	Prio
IndexNow / Sitemap	Neue URL pushen	P0
GitHub README / Gist	curl + Link zum Artikel	P0
Dev-Communities	Latenz-/Kostentabelle	P1
Newsletter / Slack	Fallback-Rezept	P1
Bezahlte Ads	Brand + API-KW	P2

KPIs: GSC-Klicks, Matomo-Verweildauer, OpenRouter Usage USD, Agent-Host-Uptime. Wöchentlich P0 schließen.

10Sechs-Schritte-Runbook: API-Key bis Produktion

01
Konto + Guthaben: Registrierung, mindestens 10 USD Credit (1.000 Free-Calls/Tag).
02
Key-Trennung: dev/staging/prod Keys, Spending Limits, E-Mail-Alerts.
03
Secrets: OPENROUTER_API_KEY in Keychain/CI-Vault auf Mac oder Cloud-Mac.
04
Smoke Tests: curl, /models, je ein Paid- und Free-Modell → HTTP 200.
05
Fallback in Git: primary/secondary/tertiary IDs, route: "fallback" versioniert.
06
Host fixieren: Agent, MCP, Runner auf dediziertem Mac via NUKCLOUD Bestellung; SSH, Logs, Usage-Dashboard verknüpfen.

11Häufige Fragen

Ist OpenRouter OpenAI-kompatibel?

Ja. base_url=https://openrouter.ai/api/v1 reicht für OpenAI SDK, LangChain und Cursor. Modell-ID im Format vendor/model setzen.

Free-Model-Limits?

25+ Free-Modelle; 50/Tag ohne Guthaben, 1.000/Tag ab 10 USD Aufladung. Paid: Anbieterpreis + 5,5 % Credit-Gebühr.

Model vs. Provider Routing?

Model Routing wählt automatisch; Provider Routing setzt provider.order für SLA oder Residency.

Wann nicht OpenRouter?

Latenz <10 ms, Milliarden-Token-Direktverträge, strikte Residency, Vendor-exklusive APIs → Direktanbindung.

Wo Agenten 24/7 hosten?

Geteilte Linux-VPS leiden unter Bandbreiten-Jitter, NAT und Overselling. Für OpenRouter-gestützte Hermes-, Claude-Code- und Kilo-Code-Workloads sind dedizierte NUKCLOUD Multi-Region Bare-Metal-Mac- / Cloud-Mac-Knoten die stabilere Produktionsoption. Siehe Preise und Knoten-Runbook.