OpenRouter API :
accéder à GPT, Claude & Gemini (guide 2026)

OpenRouter est une couche d'agrégation, pas un éditeur de modèles. L'authentification utilise Authorization: Bearer $OPENROUTER_API_KEY. Le format de requête correspond à OpenAI Chat Completions : le code SDK OpenAI existant fonctionne après modification de base_url et api_key. Les modèles suivent la convention provider/model — par ex. openai/gpt-4o, anthropic/claude-3.5-sonnet, google/gemini-2.5-pro.

• Multiplication des comptes : Les intégrations directes exigent des clés, SDK et portails de facturation séparés pour OpenAI, Anthropic, Google, Meta et DeepSeek.
• Pas de failover intégré : Quand un fournisseur limite ou tombe, votre application doit implémenter retries et basculement elle-même.
• Suivi des coûts fragmenté : Réconcilier l'usage sur cinq tableaux de bord chaque mois est source d'erreurs.

OpenRouter prend deux décisions de routage indépendantes à chaque requête :

• Failover automatique : En cas de rate limit ou d'erreur, OpenRouter bascule vers le fournisseur ou modèle de secours suivant via le tableau models — votre app ne voit généralement pas de 500.
• Niveau gratuit : 25+ modèles gratuits ; ~50 appels/jour sans crédits ; 1 000/jour et 20/min après recharge ≥10 USD.
• Modèle tarifaire : Pas de majoration token — tarifs fournisseur transmis. Commission 5,5 % (min. 0,80 USD) uniquement à l'achat de crédits. BYOK : 1 M de requêtes/mois gratuites, puis 5 % sur l'usage équivalent.

Vérifiez le comportement actuel dans la documentation officielle avant mise en production.

https://openrouter.ai/docs

https://openrouter.ai/docs/faq

• Une clé, tous les modèles : Changez de modèle en modifiant une chaîne — pas de couche d'adaptation par éditeur.
• Failover intégré : Configurez models: ["anthropic/claude-3.5-sonnet", "openai/gpt-4o", "google/gemini-2.5-pro"] et laissez la passerelle gérer le circuit breaking.
• Tableau de bord unifié : Dépenses token, latence (TTFT) et débit au même endroit.
• Pas de majoration token : Contrairement à de nombreux agrégateurs, OpenRouter transmet les tarifs fournisseur ; la commission 5,5 % ne touche que l'achat de crédits.
• Zone idéale claire : Prototypage, tests A/B multi-modèles, charges sous 10 000 USD/mois et frameworks d'agents devant tourner sur chaque modèle frontier.

Quand ne pas utiliser OpenRouter : Charges mono-modèle à dizaines de milliers de dollars par mois où la commission 5,5 % dépasse le coût d'intégration directe ; fonctionnalités spécifiques (Anthropic Prompt Caching, OpenAI Batch/Assistants, outillage Google Vertex) ; chemins sensibles à la latence où un hop passerelle supplémentaire de 10–80 ms compte ; exigences de conformité interdisant le routage via un tiers US.

Inclure des compromis honnêtes renforce l'E-E-A-T et correspond aux recherches réelles : « OpenRouter vs OpenAI API » et « OpenRouter vaut-il le coup » convertissent mieux qu'un éloge générique.

1. Créer un compte sur openrouter.ai via GitHub ou e-mail.
2. Générer une clé API dans Settings → Keys. La stocker comme OPENROUTER_API_KEY — ne jamais la committer dans git.
3. Recharger des crédits (optionnel) : Les modèles gratuits fonctionnent sans paiement. Les modèles payants exigent des crédits ; ≥10 USD débloque des quotas free tier plus élevés.
4. Choisir un modèle sur la page Models ou via GET /api/v1/models. Noter la chaîne provider/model.
5. Envoyer la première requête à https://openrouter.ai/api/v1/chat/completions et confirmer que choices[0].message.content revient.
6. Renforcer pour la production : Ajouter les en-têtes HTTP-Referer et X-Title ; configurer une chaîne de fallback models ; exécuter les agents sur un hôte macOS toujours actif pour que la mise en veille du portable n'interrompe pas les jobs longs.

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": "Explique l'informatique quantique en une phrase" }
    ]
  }'

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": "Bonjour !"}],
    extra_headers={
        "HTTP-Referer": "https://calmvps.com",
        "X-Title": "CALMVPS Blog Demo",
    },
)
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: "Explique OpenRouter en une phrase" }],
});
console.log(completion.choices[0].message.content);

Réponses en streaming :

const stream = await openai.chat.completions.create({
  model: "anthropic/claude-3.5-sonnet",
  messages: [{ role: "user", content: "Écris un court poème sur l'automne" }],
  stream: true,
});
for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}

Fallback modèle pour haute disponibilité :

{
  "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": "Bonjour" }]
}

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

• Point de terminaison : https://openrouter.ai/api/v1/chat/completions
• Catalogue : 400+ modèles de 70+ fournisseurs
• Modèles gratuits : 25+ disponibles ; ~50 appels/jour sans crédits ; 1 000/jour après recharge ≥10 USD
• Commission crédits : 5,5 % à l'achat (minimum 0,80 USD) ; +5 % pour paiement crypto
• BYOK : Apportez vos clés fournisseur — 1 M requêtes/mois gratuites, puis 5 % sur usage équivalent
• Latence passerelle : Environ 10–80 ms en plus vs appels fournisseur directs

Les tarifs token par modèle figurent sur la page OpenRouter Models et évoluent quand les fournisseurs mettent à jour leurs prix.

https://openrouter.ai/models

• OpenRouter est-il gratuit ? 25+ modèles gratuits avec rate limits. Modèles payants au tarif fournisseur ; commission 5,5 % uniquement à l'achat de crédits.
• OpenRouter facture-t-il les tokens ? Pas de majoration sur les prix token — seulement sur l'achat de crédits.
• OpenRouter vaut-il le coup ? Oui pour apps multi-modèles et besoin de failover ; non pour volume mono-fournisseur ou charges sensibles à la conformité.
• Quels modèles OpenRouter prend-il en charge ? 400+ modèles — liste live via /api/v1/models.
• OpenRouter est-il sûr ? Le trafic passe par une passerelle US. BYOK ou API directes pour données sensibles.
• OpenRouter vs API OpenAI ? OpenRouter est une passerelle qui appelle les modèles OpenAI plus Anthropic, Google, DeepSeek et autres.
• Comment fonctionne la tarification OpenRouter ? Facturation à l'usage au tarif token fournisseur plus commission sur crédits ; pas d'abonnement mensuel fixe.
• Exemple Python OpenRouter ? Pointer le SDK OpenAI vers https://openrouter.ai/api/v1 ou utiliser HTTP POST avec requests.

Si vous publiez ce tutoriel sur un blog bilingue et que les impressions anglaises restent à zéro, parcourez ces couches dans l'ordre :

P0 — Crawl et index (ROI maximal) :

• CDN/WAF bloque Googlebot : Tester avec Google Search Console URL Inspection, pas seulement votre navigateur.
• hreflang manquant : Google peut traiter l'anglais comme doublon du chinois.
• Erreurs robots.txt / noindex : Vérifier que /en/ n'est pas interdit.
• Lacunes sitemap : Lister chaque langue séparément avec annotations alternate.
• Coquilles CSR vides : Les SPA sans SSR/SSG renvoient du HTML vide aux crawlers.

P1 — Contenu (ne pas traduire — réécrire) :

• Les utilisateurs anglophones cherchent « OpenRouter vs OpenAI API » et « is OpenRouter worth it », pas des traductions littérales de titres chinois.
• Couvrir le query fan-out : définition, usage, tarifs, comparaisons, sécurité et limites dans un seul article.
• Ajouter des détails vérifiables — factures réelles, latence mesurée, numéros de version — pour l'E-E-A-T.

Cibles keyword anglaises : OpenRouter API, OpenRouter tutorial, OpenRouter vs OpenAI API, OpenRouter Python example, OpenRouter OpenAI SDK drop-in replacement, OpenRouter fallback routing, is OpenRouter free.

SEO technique : URLs en sous-répertoire (/en/, /zh/), canonicals autoréférents, JSON-LD BlogPosting + FAQPage, filtres de propriété GSC séparés par préfixe de langue.

Distribution : dev.to, Reddit (r/LocalLLaMA, r/programming), Hacker News, Indie Hackers — pas seulement les plateformes chinoises où votre domaine a déjà des liens.

• P0 cette semaine : Vérification index GSC pour /en/ ; audit logs CDN/WAF ; corriger hreflang, canonical, entrées sitemap.
• P1 rédaction : Brouillons anglais et chinois indépendants ; intégrer keywords dans titre, intro, H2, FAQ ; ajouter données structurées.
• P2 distribution : dev.to + posts communautaires ; soumettre sitemaps à GSC et Baidu Webmaster Tools pour URLs chinoises.

Suivre séparément par préfixe de langue : Impressions et CTR GSC pour /en/ vs /zh/ — zéro impression signifie que l'indexation, pas le classement, est en panne. Surveiller taux de rebond et temps de lecture dans Umami, Plausible ou GA4. Contrôler mensuellement 3–5 keywords clés en session Google US incognito.

OpenRouter résout le routage modèle, mais votre runtime agent a toujours besoin d'un hôte fiable. Mise en veille du portable, VPS Linux sans Xcode/Metal et contention VM partagée sont des modes d'échec fréquents pour Cursor, OpenClaw et agents custom appelant OpenRouter.

Pour la CI/CD iOS en production et l'automatisation d'agents IA permanents, la location Mac Mini bare metal CALMVPS constitue la base la plus solide : Apple Silicon dédié, accès root, disponibilité 7×24 et provisionnement en 120 secondes — découplez votre passerelle du backend d'inférence et changez de modèles sans toucher à la stabilité du runtime.