Guide OpenRouter API : appeler GPT, Claude & Gemini avec une seule clé (2026)
À qui s'adresse ce guide ? Aux développeurs Mac et ingénieurs IA qui comparent OpenRouter aux API directes OpenAI, Anthropic ou Google, et souhaitent router GPT, Claude et Gemini sans réécrire leur client. Ce que vous obtenez : une matrice de routage, un tableau comparatif décisionnel, un setup en 7 étapes, des exemples curl/Python/Node, le JSON fallback et une lecture honnête des tarifs (sans markup token, frais crédit 5,5 %). Contenu : trois repères chiffrés, matrice tarifaire, FAQ×6, location Mac isolée pour valider l'intégration.
Sommaire
Lecture complémentaire : classement hebdomadaire des tokens, outils CLI, tendances LLM et sélection d'agents.
Réponse directe
OpenRouter centralise l'accès aux grands modèles : une clé API OpenRouter, un endpoint compatible OpenAI (https://openrouter.ai/api/v1/chat/completions) et plus de 400 modèles — GPT, Claude, Gemini, DeepSeek, Llama, Qwen — activables en changeant une seule chaîne model. Votre code OpenAI SDK existant suffit : remplacez base_url et api_key.
01 · Synthèse & chiffres clés
En pratique, OpenRouter répond à une question simple : comment expérimenter plusieurs modèles sans multiplier les comptes fournisseur. Le compromis est un saut réseau supplémentaire, compensé par le failover intégré et la facturation consolidée.
- Un endpoint, tous les modèles — IDs
openai/gpt-4o,anthropic/claude-3.5-sonnet,google/gemini-2.5-pro. - Deux niveaux de routage — choix du modèle (
model) puis du fournisseur (provider). - Failover natif — tableau
models+route: fallback. - Tarification — pas de markup token ; 5,5 % à l'achat de crédits ; BYOK : 1 M req/mois gratuites.
Repère #1 : les leaderboards publics affichent souvent 28+ billions de tokens sur 7 jours glissants — usage agent en production, pas démo.
Repère #2 : latence gateway typique 10–80 ms selon la région.
Repère #3 : sur ~1 M tokens/mois Claude Sonnet, la marge 5,5 % représente environ 4–8 USD — souvent moins cher que trois intégrations séparées.
02 · Matrice de routage : modèle vs fournisseur
| Couche | Décision | Champ |
|---|---|---|
| Routage modèle | Quel LLM répond | model ou openrouter/auto |
| Routage fournisseur | Quel hôte upstream sert ce modèle | provider — sélection pondérée par prix |
| Fallback | Bascule auto sur 429/5xx | models + "route": "fallback" |
| Gratuit | 25+ modèles free | ~50 req/j sans crédits ; 1 000/j après 10 USD ; 20/min |
03 · OpenRouter vs API directe (OpenAI, Anthropic, Google)
La requête à forte intention en français reste souvent « OpenRouter vs OpenAI » — ce tableau structure la décision sans marketing.
| Dimension | OpenRouter | API directe |
|---|---|---|
| Clés API | Une clé, 400+ modèles | Compte et clé par éditeur |
| Migration SDK | Drop-in OpenAI (base_url) | SDK natifs ou adaptateurs |
| Prix token | Tarif liste, sans markup | Tarif liste |
| Frais plateforme | 5,5 % crédits (min. 0,80 USD) | Aucun frais gateway |
| Failover | Intégré | Retries à implémenter |
| Fonctions exclusives | Sous-ensemble | Batch OpenAI, cache Anthropic, Vertex … |
| Latence | +10–80 ms | Direct région fournisseur |
| Cas idéal | Multi-modèles, prototype, <~10k USD/mois | Volume unique, conformité, SLA <50 ms |
04 · Cinq raisons de basculer — et quand s'abstenir
- Une clé, tous les modèles — changement de fournisseur = une ligne
model. - Failover automatique — moins de code de résilience maison.
- Tableau de bord unifié — coûts, latence TTFT, mix modèles.
- Pas de surcoût token — revenu plateforme sur crédits ou BYOK.
- Modèles gratuits — hackathons et smoke tests CI.
Quand ne pas utiliser OpenRouter
- Production mono-modèle à très grand volume où 5,5 % dépasse un contrat enterprise direct.
- Besoin d'API exclusives (Assistants, Batch, prompt caching optimisé).
- Résidence des données interdisant un gateway US tiers.
- SLA inférence sub-50 ms.
Documenter les limites renforce la crédibilité — et répond aux requêtes « OpenRouter vaut-il le coup » avec nuance.
05 · Setup en 7 étapes : obtenir votre clé OpenRouter
- Créer un compte sur openrouter.ai (SSO GitHub/Google).
- Keys → Create Key ; nommer par environnement (
dev-mac-sandbox). - Plafond de crédits sur la clé si billing partagé.
- Exporter :
export OPENROUTER_API_KEY="sk-or-..."— jamais dans Git. - Crédits optionnels (10 USD min pour quotas free élevés) ; crypto +5 %.
- Requête test curl avant Cursor, LangChain ou OpenClaw.
- BYOK optionnel : coller clés upstream — 1 M req/mois routées sans frais.
06 · Exemples de code
6.1 cURL
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." }
]
}'6.2 Python (SDK OpenAI)
import os
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key=os.environ["OPENROUTER_API_KEY"],
)
completion = client.chat.completions.create(
model="google/gemini-2.5-pro",
messages=[{"role": "user", "content": "Bonjour depuis OpenRouter !"}],
)
print(completion.choices[0].message.content)6.3 JSON fallback 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" }]
}6.4 Streaming Node.js
const stream = await openai.chat.completions.create({
model: "openai/gpt-4o",
messages: [{ role: "user", content: "Un haïku sur l'automne." }],
stream: true,
});
for await (const chunk of stream) {
const c = chunk.choices[0]?.delta?.content;
if (c) process.stdout.write(c);
}07 · Grille tarifaire
| Type | Taux | Note |
|---|---|---|
| Tokens modèles payants | Prix liste fournisseur | Sans markup OpenRouter |
| Achat crédits | 5,5 % (min. 0,80 USD) | À la recharge |
| Crypto | +5 % | En plus des frais crédits |
| BYOK | 0 USD — 1 M req/mois | Puis 5 % équivalent |
| Modèles gratuits | 0 USD tokens | 50/j default ; 1 000/j après 10 USD |
08 · Checklist de validation en cinq points
- Machine isolée : clé jetable, curl sur trois IDs (GPT, Claude, Gemini).
- SDK OpenAI →
base_url=https://openrouter.ai/api/v1; schéma identique. stream: true— mesurer TTFT vs baseline directe.- Poster JSON fallback ; simuler échec — vérifier la chaîne.
- Journaliser latence/tokens/coût, révoquer la clé, effacer l'environnement.
09 · FAQ×6
Q : Qu'est-ce qu'OpenRouter ?
R : Passerelle LLM unifiée — une clé, endpoint compatible OpenAI, 70+ fournisseurs, 400+ modèles.
Q : Y a-t-il un markup sur les tokens ?
R : Non. 5,5 % à l'achat de crédits (min. 0,80 USD) ou 5 % BYOK au-delà de 1 M/mois.
Q : OpenRouter vaut-il le coup vs OpenAI direct ?
R : Multi-modèles et failover modérés : oui. Hyperscale ou conformité stricte : API directe.
Q : SDK Python OpenAI compatible ?
R : Oui — base_url + clé, model en fournisseur/modèle.
Q : Routage fallback ?
R : models + "route": "fallback" — bascule séquentielle sans retry client.
Q : Sécurité production ?
R : Clés par environnement, rotation, hardware isolé, BYOK si conformité l'exige.
10 · Louer un Mac isolé pour tester OpenRouter
Un VPS Linux exécute curl — mais Cursor BYOK, OpenClaw et le Keychain macOS reflètent le workflow réel des équipes Mac. Alterner GPT, Claude et Gemini sur le Mac principal pollue .zshrc, mélange les caches et laisse des configs fallback.
La location à la journée sur Apple Silicon isolé suit le rythme « clé → benchmark → révocation → destruction du nœud ». Tarifs : grille MacDate.
11 · Sources
Dernière mise à jour : 24 juillet 2026 | Tarifs selon docs OpenRouter à la date de publication