OpenRouter API: Ein Key für GPT, Claude und Gemini — von null bis zur produktionsreifen Anbindung

Was OpenRouter technisch ist — und wo die Reibungspunkte liegen

OpenRouter ist ein LLM-API-Gateway: Ein Authorization: Bearer-Key und der Endpoint https://openrouter.ai/api/v1/chat/completions reichen aus, um GPT-, Claude-, Gemini-, Llama-, DeepSeek-, Qwen- und Mistral-Modelle anzusprechen — ohne pro Anbieter eigene SDK-Integration und ohne getrennte Abrechnungsportale.

• Protokoll: OpenAI Chat Completions — bestehender Client-Code braucht in der Regel nur geänderte base_url und api_key.
• Modell-ID: Schema anbieter/modell, z. B. openai/gpt-4o, anthropic/claude-3.5-sonnet, google/gemini-2.5-pro, deepseek/deepseek-chat.
• Typische Schmerzpunkte ohne Gateway: parallele Vendor-Accounts, uneinheitliche Fehlercodes, manuelles Fallback bei Rate-Limits, fragmentierte Kostenübersicht — OpenRouter adressiert diese operativen Kosten, nicht die Modellqualität selbst.

Entscheidend für das erwartete Laufzeitverhalten sind zwei unabhängige Routing-Ebenen:

Bei Ausfall oder Rate-Limit des primären Providers schaltet OpenRouter auf den nächsten verfügbaren Anbieter oder das nächste Modell in der models-Fallback-Kette um — ohne eigenes Circuit-Breaker-Pattern in der Anwendung.

OpenRouter vs. Direkt-API — Entscheidungsmatrix

Die folgende Tabelle fasst die messbaren Unterschiede zusammen. Token-Preise können sich ändern; die Struktur der Trade-offs bleibt stabil.

Fünf Vorteile — und wann OpenRouter die falsche Wahl ist

Vorteil 1 — Ein Key, alle Modelle: Modellwechsel = eine geänderte model-Zeichenkette; kein neuer Adapter pro Vendor.

Vorteil 2 — Automatisches Failover: Explizite models-Kette mit route: "fallback"; OpenRouter versucht sequenziell Alternativen.

Vorteil 3 — Zentralisierte Metriken: Dashboard für Kosten, TTFT und Durchsatz über alle angebundenen Modelle.

Vorteil 4 — Kein Token-Markup: Laut OpenRouter-FAQ werden Token zum Anbieterlistenpreis abgerechnet; Gebühr entsteht primär beim Credit-Kauf (5,5 %, min. 0,80 USD).

Vorteil 5 — Klares Einsatzprofil: Prototyping, Multi-Modell-A/B-Tests, mittlere Volumina (typisch unter einigen tausend USD/Monat), Anwendungen mit hoher Verfügbarkeitsanforderung ohne eigenes Routing-Team.

Sechs Schritte zur produktionsreifen OpenRouter-Anbindung

Empfohlen wird eine saubere macOS-Umgebung — isoliert von produktiven Python-/Node-Installationen auf dem Hauptrechner.

1. Account anlegen: Registrierung auf openrouter.ai per GitHub oder E-Mail.
2. API-Key erzeugen: Dashboard → Keys; Key in OPENROUTER_API_KEY speichern, nicht ins Repository committen.
3. Credits aufladen (optional): Für kostenpflichtige Modelle Guthaben erforderlich; 5,5 % Gebühr beim Kauf. Ohne Guthaben stehen 25+ Free-Modelle mit Limits zur Verfügung.
4. Modellkatalog abfragen: GET /api/v1/models für aktuelle IDs und Preise.
5. Ersten Request senden: curl oder SDK gegen /v1/chat/completions.
6. Streaming und Fallback verifizieren: stream: true und models-Array vor Produktivgang testen.

curl https://openrouter.ai/api/v1/models \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-3.5-sonnet",
    "messages": [
      { "role": "user", "content": "Erkläre Quantencomputing in einem Satz." }
    ]
  }'

import requests
import os

response = requests.post(
    url="https://openrouter.ai/api/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "google/gemini-2.5-pro",
        "messages": [
            {"role": "user", "content": "Schreibe Quicksort in Python."}
        ],
    },
)
print(response.json()["choices"][0]["message"]["content"])

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

completion = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
    extra_headers={
        "HTTP-Referer": "https://your-app-domain.com",
        "X-Title": "My App",
    },
)
print(completion.choices[0].message.content)

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

const completion = await openai.chat.completions.create({
  model: "deepseek/deepseek-chat",
  messages: [{ role: "user", content: "Explain OpenRouter in one sentence" }],
});

console.log(completion.choices[0].message.content);

const stream = await openai.chat.completions.create({
  model: "anthropic/claude-3.5-sonnet",
  messages: [{ role: "user", content: "Schreibe ein kurzes Gedicht über den Herbst." }],
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}

{
  "model": "anthropic/claude-3.5-sonnet",
  "models": [
    "anthropic/claude-3.5-sonnet",
    "openai/gpt-4o",
    "google/gemini-2.5-pro"
  ],
  "route": "fallback",
  "messages": [{ "role": "user", "content": "Hello" }]
}

Free-Tier, BYOK und Preisstruktur — harte Zahlen

• Free-Modelle: 25+ kostenlose Modelle (u. a. Llama-, Gemma-, DeepSeek-Varianten). Unaufgeladenes Konto: ca. 50 Anfragen/Tag; ab 10 USD Guthaben: ca. 1.000 Anfragen/Tag, 20/Minute.
• BYOK (Bring Your Own Key): Eigene Vendor-Keys hinterlegen — erste 1 Mio. Anfragen/Monat ohne OpenRouter-Servicegebühr, darüber 5 % auf den entsprechenden Anteil.
• Token-Abrechnung: Listenpreis des Anbieters, kein Token-Aufschlag laut FAQ; Gebühr beim Credit-Kauf 5,5 % (min. 0,80 USD), Krypto-Zahlung zusätzlich 5 %.
• Kostenkontrolle: Dashboard zeigt Prompt-/Completion-Preis und Ist-Verbrauch pro Modell — relevant bei parallelen A/B-Läufen.

Free-Tier-Limits, Modelllisten und Gebührensätze können sich ändern — maßgeblich sind die offiziellen Quellen, nicht dieser Artikel.

OpenRouter — offizielle Dokumentation

OpenRouter — FAQ zu Preisen und BYOK

OpenRouter — Provider-Routing-Mechanismus

FAQ

OpenRouter vereinheitlicht API-Zugang, nicht die lokale Entwicklungsumgebung: Python-Venv-Konflikte, halb installierte Agent-Frameworks und vergessene Hintergrundprozesse belasten schnell den Hauptrechner. Für Multi-Modell-Experimente, Next.js-Prototypen oder dauerhaft laufende Agenten eignet sich ein isolierter, physischer Apple-Silicon-Mac mini — tageweise mietbar, jederzeit zurücksetzbar. Das gleiche Prinzip haben wir beim Kimi-K3-API-Test und beim Xcode-CI-Runner-Setup beschrieben; OpenRouter-Integrationen profitieren davon gleichermaßen. Wer personenbezogene Testdaten durch OpenRouter leitet, sollte zusätzlich den DSGVO-Aspekt des US-Gateway-Routings gegen den Nutzen der Vereinfachung abwägen.