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.

Noeuds de reseau neuronal abstraits et routage API symbolisant OpenRouter comme passerelle LLM unifiee

Sommaire

1. Trois points de douleur : le chaos des cles multi-fournisseurs

  1. 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.
  2. Pas de failover integre. Face a un 429 ou 500, vous devez coder circuit breaker, retries et downgrade vous-meme.
  3. 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.

Routage interne (apercu technique)

CoucheDecisionChamp de controle
Model RoutingQuel modele repondmodel ou openrouter/auto
Provider RoutingQuel fournisseur traite la requeteObjet 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

DimensionOpenRouterAPI directes
Nombre de cles1 cle, 400+ modelesCle + SDK par fournisseur
MigrationChanger base_url + api_keyNouvel adaptateur par editeur
FailoverFallback gateway + changement fournisseurLogique retry/downgrade maison
FacturationDashboard uniquePlusieurs consoles
Prix tokenPas de markup, tarif fournisseurTarif officiel
Frais de recharge5,5 % (min. 0,80 USD), crypto +5 %Aucun (carte directe)
Latence extra~10–80 ms saut gatewayMinimum
Fonctions exclusivesPas de Batch API, Prompt Caching, etc.Stack officielle complete

4. Cinq avantages cles d OpenRouter

  1. Une cle pour tous les modeles — migration quasi nulle. Changer de modele = modifier la chaine model ; corps et streaming identiques.
  2. Failover automatique inter-fournisseurs. La gateway gere retry et bascule — pas de circuit breaker cote client.
  3. Facturation et analytics unifies. Un dashboard pour cout, TTFT et debit de tous les modeles.
  4. Pas de surcout token. Seulement 5,5 % a la recharge ; BYOK : 1 M req/mois gratuites.
  5. Cas d usage clairs. Prototypes, A/B test, volumes moyens, fallback multi-modeles.

5. Quand OpenRouter n est pas le bon choix

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 :

export OPENROUTER_API_KEY="sk-or-v1-..."

Etape 3 — Premiere requete (test de connectivite)

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"}] }'

Etape 4 — SDK OpenAI (migration minimale)

Deux lignes a modifier dans le code OpenAI existant :

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-domain.com", "X-Title": "My Agent Demo", }, ) print(completion.choices[0].message.content)

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)

import requests, 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": "Ecris un tri rapide en Python"}], }, ) print(response.json()["choices"][0]["message"]["content"])

7.2 Node.js (OpenAI SDK)

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);

7.3 Streaming

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

7.4 Lister les modeles disponibles

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

8. Fallback, modeles gratuits et controle des couts

8.1 Fallback multi-modeles

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

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

9. Faits techniques citables

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)

10.2 Couche contenu

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

CanalLangueUsage
dev.to / Medium FRFrancaisDiffusion tutoriel
HN / Reddit / dev.toAnglaisAudience tech, backlinks
GSC / BingFR/ENSitemap, 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.