OpenRouter API : guide complet pour appeler GPT, Claude et Gemini (2026)

OpenRouter est une passerelle LLM unifiée : un compte, une clé sk-or-..., un endpoint REST compatible OpenAI. Vous appelez openai/gpt-5.6-sol, anthropic/claude-sonnet-5 ou google/gemini-2.5-pro sans changer de client HTTP. La plateforme route plus de 100 billions de tokens par mois (juin 2026) et agrège 70+ fournisseurs et 400+ modèles — voir aussi notre analyse des tendances LLM OpenRouter.

Le nommage suit toujours vendor/model-id. Les en-têtes HTTP recommandés incluent HTTP-Referer et X-Title pour le classement apps ; le corps JSON reprend le schéma OpenAI (messages, stream, max_tokens). Pour lister les modèles disponibles : GET /api/v1/models.

• Fragmentation des clés : rotation, quotas et alertes budget triplés ; un agent oublié peut vider une clé Anthropic pendant qu'OpenAI reste inutilisée.
• Fallback artisanal : scripts maison qui basculent entre endpoints — sans SLA unifié ni journalisation centralisée des erreurs 429/503.
• Surprise de latence : chaque saut proxy ajoute typiquement 10–80 ms ; acceptable pour agents batch, problématique pour chat vocal temps réel.
• Conformité floue : données qui traversent un agrégateur US alors que le contrat exige un DPA direct avec un seul fournisseur.
• Hôte instable : gateway Hermes ou Claude Code sur VPS macOS mutualisé — jitter réseau, surbooking CPU et coupures de longues connexions SSE qui tuent les sessions agent avant un mauvais modèle.

OpenRouter propose deux stratégies de routage. Le choix impacte coût, latence et résilience.

Modèles gratuits : plus de 25 modèles en accès gratuit — 50 requêtes/jour sans crédit, puis 1 000/jour après recharge de 10 $. Idéal pour prototypage ; pas pour production agent 7×24.

• Un seul SDK : migrez en changeant base_url et model — zéro fork client.
• Fallback natif : chaînes multi-modèles sans orchestrateur maison.
• BYOK sans markup token : branchez vos clés OpenAI/Anthropic/Google — 1 M req/mois gratuites côté plateforme.
• Visibilité marché : classements apps et modèles pour calibrer stack et budget — aligné avec nos bilans parts modèles juin 2026.
• Expérimentation rapide : tester Kimi K3, DeepSeek V4 ou Grok 4.5 en une ligne sans nouveau compte.

1. A
   Créer un compte sur openrouter.ai, générer une clé API, optionnellement activer BYOK pour vos clés fournisseurs.
2. B
   Exporter OPENROUTER_API_KEY=sk-or-... dans l'environnement du nœud (Mac local ou cloud).
3. C
   Tester un appel curl (section code) puis brancher votre SDK existant sur https://openrouter.ai/api/v1.

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://votredomaine.com" \
  -H "X-Title: Mon Agent" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [{"role": "user", "content": "Explique le routage OpenRouter en 3 phrases."}]
  }'

Python — requests :

import os, requests
r = requests.post(
    "https://openrouter.ai/api/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}",
        "HTTP-Referer": "https://votredomaine.com",
    },
    json={
        "model": "openai/gpt-5.6-sol",
        "messages": [{"role": "user", "content": "Hello"}],
    },
    timeout=120,
)
print(r.json()["choices"][0]["message"]["content"])

Python — SDK OpenAI :

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="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Résume en français."}],
)
print(resp.choices[0].message.content)

Node — SDK OpenAI :

import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});
const completion = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  messages: [{ role: "user", content: "Bonjour" }],
});
console.log(completion.choices[0].message.content);

Streaming (Node) :

const stream = await client.chat.completions.create({
  model: "openai/gpt-5.6-sol",
  messages: [{ role: "user", content: "Stream test" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Fallback multi-modèles :

{
  "models": [
    "anthropic/claude-sonnet-5",
    "openai/gpt-5.6-sol",
    "google/gemini-2.5-pro"
  ],
  "messages": [{"role": "user", "content": "Tâche critique"}],
  "route": "fallback"
}

Lister les modèles :

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

En mode Bring Your Own Key, OpenRouter relaie vos clés directes : pas de markup token, quota gratuit de 1 million de requêtes/mois sur la plateforme. Les crédits prépayés OpenRouter facturent le tarif affiché du modèle plus 5,5 % à l'achat de crédits — pas de surcoût caché par token consommé.

• Point 1 : activez les alertes budget dans la console avant de lancer un agent Hermes 7×24.
• Point 2 : journalisez model, provider, tokens et latence côté client — OpenRouter expose un ID de génération pour le support.
• Point 3 : pour Claude Code ou Cursor, configurez OPENROUTER_API_KEY et la base URL dans les paramètres IDE — voir le guide Agent Skills.

Si votre documentation OpenRouter ou votre blog technique peine en anglais ou en français malgré un bon contenu zh, vérifiez cette checklist :

• Search Console : pages indexées par locale, requêtes réelles vs impressions, erreurs d'exploration.
• CDN / WAF : blocage géographique ou bot filter sur /en/ ou /fr/.
• hreflang : matrice cohérente sur la page index blog, pas sur chaque article détail (convention NUKCLOUD).
• Traduction automatique : contenu dupliqué ou qualité linguistique pénalisée — réécrire, ne pas traduire mot à mot.
• Backlinks : ancres en langue cible depuis docs dev, GitHub README et communautés (Dev.to, Hacker News Show).

Règle d'or : localiser l'intention de recherche, pas traduire la structure zh mot pour mot. Chaque locale NUKCLOUD possède son propre blog-data.js et ses slugs identiques mais titres natifs.

• URL : https://nukcloud.com/{lang}/blog/{slug}.html — slug identique sur les 8 langues.
• Canonical : auto-référent sur chaque détail ; pas de hreflang sur les articles (liste index uniquement).
• Sitemap : régénérer via le script projet après publication ; soumettre dans GSC par propriété.
• Schema : BlogPosting + FAQPage embarqué dans mainEntity — comme cet article.
• IndexNow : pousser les nouvelles URLs pour Bing/Yandex selon le runbook site.

Métriques à suivre (30 jours) : impressions GSC par locale, CTR title, temps sur page > 4 min, clics vers tarifs et commander, inscriptions console corrélées UTM ?utm_source=blog&utm_campaign=openrouter-api.

1. 01
   Compte et clés : créer le compte OpenRouter, générer sk-or-..., configurer BYOK si vous avez déjà des crédits OpenAI/Anthropic, plafond budget à 80 % du seuil alerte.
2. 02
   Smoke test local : curl + SDK OpenAI sur votre poste ; valider streaming et fallback JSON avec trois modèles.
3. 03
   Provisionner le nœud : console NUKCLOUD — Mac mini M4 32 Go+ pour agents parallèles ; région proche de votre registry Git.
4. 04
   Baseline SSH : brew install node python@3.12, secrets dans ~/.zshrc, tester latence vers openrouter.ai (< 100 ms depuis le nœud).
5. 05
   Gateway agent : launchd pour Hermes / Claude Code / service maison ; prompts récurrents en SKILL.md — voir install Hermes.
6. 06
   Revue bihebdomadaire : coût OpenRouter vs nœud, P95 latence, board apps ; ajuster chaîne fallback et spec RAM sur tarifs.

Les pools macOS mutualisés échangent un démarrage rapide contre jitter bande passante, surbooking et resets de longues connexions SSE — fatal quand un agent enchaîne des milliers d'appels outils. Pour des gateways OpenRouter 7×24 auditable, les nœuds Mac bare-metal multi-régions NUKCLOUD offrent frontière locataire, Seatbelt et RAM unifiée prévisibles — test horaire sur commander, puis engagement mensuel.