Guide OpenRouter pas a pas : integrer GPT/Claude/Gemini de zero (guide API complet 2026)
Pour brancher Cursor, OpenClaw ou vos Agents sur GPT, Claude et Gemini sans gerer cinq cles et SDK, ce guide presente OpenRouter comme passerelle LLM unifiee : principe de routage, tableau vs API directes, cinq avantages et limites, runbook en cinq etapes, code curl/Python/Node, fallback, tarifs et BYOK, diagnostic SEO multilingue et FAQ.
Sommaire
- 1. Trois points de douleur a l integration
- 2. Qu est-ce qu OpenRouter
- 3. Comparaison avec les API directes
- 4. Cinq avantages cles
- 5. Quand ne pas utiliser OpenRouter
- 6. Runbook en cinq etapes
- 7. Exemples de code
- 8. Fallback, modeles gratuits, couts
- 9. Faits techniques citables
- 10. Strategie SEO et diagnostic trafic
- 11. FAQ
- 12. Conclusion
1. Trois points de douleur : le chaos des cles multi-fournisseurs
- Comptes et cles fragmentes. OpenAI, Anthropic, Google, Meta et DeepSeek imposent chacun inscription, facturation et SDK — changer de modele revient a reecrire la couche d adaptation.
- Pas de failover integre. Face a un 429 ou 500, vous devez coder circuit breaker, retries et downgrade vous-meme.
- Reconciliation de factures lourde. Cinq consoles pour tokens, latence et cout compliquent l optimisation du routage Agent.
2. OpenRouter — passerelle API LLM unifiee
OpenRouter est une couche d agregation : avec une cle API et un endpoint compatible OpenAI, vous appelez 400+ modeles de 70+ fournisseurs (GPT, Claude, Gemini, Llama, DeepSeek, Qwen, Mistral, etc.) sans compte separe par editeur.
- Endpoint :
https://openrouter.ai/api/v1/chat/completions - Auth :
Authorization: Bearer $OPENROUTER_API_KEY - Protocole : OpenAI Chat Completions — le code OpenAI existant change surtout
base_urletapi_key - Nommage :
fournisseur/modele, ex.openai/gpt-4o,anthropic/claude-3.5-sonnet,google/gemini-2.5-pro
Routage interne (apercu technique)
| Couche | Decision | Champ de controle |
|---|---|---|
| Model Routing | Quel modele repond | model ou openrouter/auto |
| Provider Routing | Quel fournisseur traite la requete | Objet provider ; defaut : prix inversement pondere + stabilite |
Si le fournisseur principal est limite ou en erreur, OpenRouter bascule vers le suivant ou un modele de secours (models) — sans renvoyer 500 a votre app.
3. OpenRouter vs appels directs OpenAI / Anthropic
| Dimension | OpenRouter | API directes |
|---|---|---|
| Nombre de cles | 1 cle, 400+ modeles | Cle + SDK par fournisseur |
| Migration | Changer base_url + api_key | Nouvel adaptateur par editeur |
| Failover | Fallback gateway + changement fournisseur | Logique retry/downgrade maison |
| Facturation | Dashboard unique | Plusieurs consoles |
| Prix token | Pas de markup, tarif fournisseur | Tarif officiel |
| Frais de recharge | 5,5 % (min. 0,80 USD), crypto +5 % | Aucun (carte directe) |
| Latence extra | ~10–80 ms saut gateway | Minimum |
| Fonctions exclusives | Pas de Batch API, Prompt Caching, etc. | Stack officielle complete |
4. Cinq avantages cles d OpenRouter
- Une cle pour tous les modeles — migration quasi nulle. Changer de modele = modifier la chaine
model; corps et streaming identiques. - Failover automatique inter-fournisseurs. La gateway gere retry et bascule — pas de circuit breaker cote client.
- Facturation et analytics unifies. Un dashboard pour cout, TTFT et debit de tous les modeles.
- Pas de surcout token. Seulement 5,5 % a la recharge ; BYOK : 1 M req/mois gratuites.
- Cas d usage clairs. Prototypes, A/B test, volumes moyens, fallback multi-modeles.
5. Quand OpenRouter n est pas le bon choix
- Un seul modele, tres gros volume (depenses mensuelles a cinq chiffres USD) — les 5,5 % de recharge justifient le direct.
- Fonctions exclusives editeur — Prompt Caching Anthropic, Batch/Assistants OpenAI, Vertex AI Google.
- Latence ultra-critique — le saut gateway 10–80 ms est inacceptable.
- Conformite / residence des donnees — pas de routage via intermediaire US.
6. Runbook — integrer l API OpenRouter en cinq etapes
Etape 1 — Creer un compte
Allez sur openrouter.ai et inscrivez-vous. Configurez des alertes de recharge pour eviter qu un Agent en boucle epuise les credits.
Etape 2 — Obtenir une cle API
Dashboard → Keys → Create Key. Stockez-la en variable d environnement, jamais dans Git :
Etape 3 — Premiere requete (test de connectivite)
Etape 4 — SDK OpenAI (migration minimale)
Deux lignes a modifier dans le code OpenAI existant :
Etape 5 — Configurer le fallback et deployer sur Mac cloud
Les Agents de production ont besoin d une chaine models et d un Gateway sur VPSMAC Mac cloud avec launchd — voir section 8 et conclusion.
7. Exemples de code (curl / Python / Node.js / OpenAI SDK)
7.1 Python (requests)
7.2 Node.js (OpenAI SDK)
7.3 Streaming
7.4 Lister les modeles disponibles
8. Fallback, modeles gratuits et controle des couts
8.1 Fallback multi-modeles
En cas de limite ou d erreur, OpenRouter essaie le modele suivant sans retry client supplementaire.
8.2 Modeles gratuits et quotas
25+ modeles gratuits (Llama, Gemma, DeepSeek free). Sans solde ~ 50 requetes/jour ; a partir de 10 USD de credits : 1000/jour, 20/min. Ideal pour prototypes — donnees sensibles en production via API payante.
8.3 Tarification
- Pas de markup token — tarif fournisseur transmis tel quel.
- Recharge credits : 5,5 % (min. 0,80 USD), crypto +5 %.
- BYOK : 1 M requetes/mois gratuites, puis 5 % sur la part equivalente.
9. Faits techniques citables
- 70+ fournisseurs, 400+ modeles — un endpoint pour GPT-4o, Claude 3.5, Gemini 2.5, DeepSeek, Llama.
- Latence gateway ~10–80 ms — a budgeter dans le SLA.
- 25+ modeles gratuits — 50/jour sans solde, 1000/jour apres 10 USD.
- Frais recharge 5,5 % — au tres gros volume, evaluer l API directe.
- BYOK 1 M/mois gratuit — pertinent pour usage moyen a large.
10. Strategie SEO et diagnostic trafic pour blogs multilingues
Sur un blog VPSMAC multilingue, l ecart de trafic FR/EN sur un tutoriel OpenRouter vient souvent de ces facteurs — checklist par priorite :
10.1 Crawl et index (P0)
- CDN/WAF bloque Googlebot — tester via GSC « Inspection d URL », pas seulement le navigateur.
- robots.txt / noindex — ne pas bloquer
/fr/ou/en/par erreur. - Sitemap — chaque locale en entree
<url>separee. - CSR vide — rendu 100 % client = HTML vide pour les crawlers.
10.2 Couche contenu
- Ne pas traduire mot a mot l anglais — on cherche plutot « OpenRouter vs OpenAI API », « OpenRouter gratuit », « exemple Python OpenRouter ».
- Definition dans les 150 premiers caracteres — snippets et AI Overviews.
- FAQ long-tail — « OpenRouter est-il payant ? », « cle API OpenRouter », « fallback OpenRouter ».
10.3 Matrice mots-cles francais
Coeur : OpenRouter, API OpenRouter, tutoriel OpenRouter. Milieu : OpenRouter vs OpenAI, modeles gratuits, tarifs. Longue traine : obtenir cle API, modeles supportes, vs Claude direct, securite.
10.4 Matrice anglaise (re-ecriture, pas traduction)
Coeur : OpenRouter API, OpenRouter tutorial. Comparaison : OpenRouter vs OpenAI API, is OpenRouter worth it. How-to : OpenRouter Python example, fallback routing, streaming.
10.5 Canaux
| Canal | Langue | Usage |
|---|---|---|
| dev.to / Medium FR | Francais | Diffusion tutoriel |
| HN / Reddit / dev.to | Anglais | Audience tech, backlinks |
| GSC / Bing | FR/EN | Sitemap, impressions par chemin |
10.6 Metriques
GSC separe /fr/ et /en/ : 0 impression = probleme d index ; impressions hautes, CTR bas = titre/description. Verifier 3–5 requetes cles en navigation privee chaque mois.
11. FAQ
OpenRouter est-il payant ? Modeles payants au prix token d origine ; recharge 5,5 %. 25+ gratuits avec quota journalier.
Fonctionne-t-il en France ? Depend du reseau ; production via sortie stable ou Mac cloud.
Quels modeles ? 400+, format fournisseur/modele, liste via /api/v1/models.
Est-ce sur ? Routage tiers — conformite : API directe ou self-hosting.
Compatible SDK OpenAI ? Oui — changer base_url et api_key.
Peu de trafic EN ? Verifier l index, puis mots-cles et qualite (pas de traduction automatique).
12. Conclusion et recommandation
Faire tourner un Agent OpenRouter sur laptop ou VPS Linux echoue souvent au meme endroit : couvercle ferme = gateway mort ; Linux sans toolchain Apple native ; reseau instable tue API et gateway ensemble. OpenRouter resout l integration multi-modeles, mais le runtime decide du 7x24 — Docker ajoute abstraction et ops.
Meilleure pratique 2026 : OpenRouter pour le choix de modele + cle API propre + VPSMAC Mac cloud pour le Gateway OpenClaw — changement de modele = ajuster la route, runtime natif macOS avec launchd. Apres validation OpenRouter, enchainez avec acceptance launchd et sondes fallback sur Mac cloud — le gateway ne doit pas dormir avec la machine de dev.