Guide complet 2026 · Code Python & Node.js · Fallbacks · Tarifs · Correctifs SEO
En bref : OpenRouter est une passerelle LLM unifiée — un point de terminaison compatible OpenAI (https://openrouter.ai/api/v1/chat/completions) et une clé API pour accéder à 400+ modèles de 70+ fournisseurs. Remplacez base_url dans le SDK OpenAI et changez le slug model (ex. anthropic/claude-3.5-sonnet). Ce guide couvre le routage, une comparaison honnête vs APIs directes, les étapes de configuration, le code streaming et fallback, tarifs/BYOK, pourquoi le trafic blog anglais stagne, et l'architecture SEO bilingue — plus la validation d'agents OpenClaw sur un Mac distant.
OpenRouter se place entre votre application et les fournisseurs de modèles. Deux couches de routage comptent :
| Couche | Décide | Champ |
|---|---|---|
| Routage modèle | Quel modèle répond | model ou openrouter/auto |
| Routage fournisseur | Quel hôte exécute ce modèle | provider (pondéré par prix par défaut) |
Comptes, clés, SDK et factures séparés par vendeur.
Vous gérez retry, changement de fournisseur et fallback de modèle.
Tableaux de bord coût et latence fragmentés.
Beaucoup d'agrégateurs majorant les tokens ; OpenRouter non.
La passerelle ajoute ~10–80 ms — inacceptable pour certaines charges sensibles à la latence ou conformité.
| Dimension | OpenRouter | API directe |
|---|---|---|
| Onboarding | Une clé, compatible OpenAI | Clés et SDK par vendeur |
| Changement de modèle | Modifier la chaîne model | Couches d'adaptation ou nouveau SDK |
| Failover | Natif à la passerelle | Circuit breakers personnalisés |
| Tarifs | Transparence fournisseur + 5,5 % rechargement | Prix catalogue ; deals enterprise à l'échelle |
| Fonctions exclusives | Batch, Prompt Caching, outils Vertex parfois absents | Stack complet |
| Latence | +10–80 ms de saut | Plus basse |
| Conformité | Passerelle US dans le chemin | Points de terminaison régionaux disponibles |
Quand NE PAS utiliser OpenRouter : Hyperscale mono-modèle (dépenses mensuelles où 5,5 % de rechargement dépasse le coût d'accords directs), Anthropic Prompt Caching ou OpenAI Batch/Assistants, SLO latence sub-10 ms, ou résidence des données interdisant un intermédiaire US. Des compromis honnêtes rankent mieux dans Google AI Overviews et créent la confiance.
Créer un compte sur openrouter.ai.
Générer une clé API ; stocker comme OPENROUTER_API_KEY.
Ajouter des crédits si modèles payants requis (frais 5,5 %).
Lister les modèles : GET /api/v1/models.
Envoyer votre première completion ; en-têtes optionnels HTTP-Referer et X-Title pour le classement.
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":"Explain quantum computing in one sentence"}]}'from openai import OpenAI
import os
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key=os.environ["OPENROUTER_API_KEY"],
)
r = client.chat.completions.create(
model="openai/gpt-4o",
messages=[{"role": "user", "content": "Hello!"}],
extra_headers={"HTTP-Referer": "https://your-site.com", "X-Title": "Demo"},
)
print(r.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 stream = await openai.chat.completions.create({
model: "deepseek/deepseek-chat",
messages: [{ role: "user", content: "Haiku about autumn" }],
stream: true,
});
for await (const chunk of stream) {
const t = chunk.choices[0]?.delta?.content;
if (t) process.stdout.write(t);
}Fallback de 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": "Hello"}]
}Faits citables : 70+ fournisseurs, 400+ modèles ; pas de majoration inference ; latence passerelle ~10–80 ms. Associez avec le routage modèles OpenClaw pour les budgets production.
| Couche | Vérifications |
|---|---|
| Crawl & index | CDN/WAF bloque Googlebot ; hreflang manquant ; robots.txt bloque /en/ ; lacunes sitemap ; coquilles CSR vides |
| Contenu | Anglais traduit automatiquement ; mots-clés « OpenRouter Advantages » vs « OpenRouter vs OpenAI API » ; E-E-A-T faible |
| Liens | Distribution chinoise sur Zhihu/Juejin mais pas de backlinks dev.to, Reddit ou HN |
Ordre des correctifs : inspection URL GSC → test CDN/WAF → hreflang + canonical + sitemap → réécrire 3–5 posts anglais nativement → distribuer sur dev.to / Reddit.
Requêtes cibles : OpenRouter API, how to use OpenRouter, OpenRouter vs OpenAI API, is OpenRouter worth it, OpenRouter Python example. Ne traduisez pas les titres chinois — un mot signal (Complete Guide / Step-by-Step) plus un élément concret (2026, Python & Node.js).
Motif URL : sous-répertoires /zh/... et /en/.... Chaque page nécessite hreflang correspondant, canonical auto-référent et FAQPage JSON-LD avec questions naturelles (OpenRouter est-il gratuit ?).
Distribution : dev.to (anglais), Juejin/V2EX (chinois), Hacker News pour la profondeur. Suivre les impressions GSC par préfixe /en/ — zéro impression signifie que l'indexation, pas le ranking, est cassée.
25+ modèles gratuits avec limites quotidiennes. Usage payant aux tarifs fournisseur ; 5,5 % uniquement à l'achat de crédits.
Pas de majoration token. Les frais s'appliquent à l'achat de crédits, pas par token au moment de l'inference.
400+ slugs de GPT, Claude, Gemini, DeepSeek, Llama, Qwen, Mistral et plus — interroger GET /api/v1/models.
Le trafic transite par OpenRouter vers les fournisseurs. Pour résidence stricte ou zéro intermédiaire : APIs directes ou BYOK avec revue de politique.
OpenRouter est le chemin le plus rapide vers des agents multi-modèles si vous acceptez une petite taxe de latence et des APIs exclusives vendeur parfois absentes. OpenClaw ou Claude Code sur macOS ajoutent une contrainte : OAuth, UI Gateway et dialogues de permission nécessitent une session GUI, pas SSH seul.
Acheter un Mac pour du travail agent épisodique implique politiques veille, mises à jour OS et amortissement. Les Mac distants VNCMac permettent de valider le routage OpenRouter dans la même session bureau que votre Gateway — voir tarifs ou la page d'accueil.