OpenRouter API Une clé 400+ modèles 2026-07-24

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.

Passerelle OpenRouter API unifiée : une clé appelle GPT Claude Gemini et plus de 400 modèles LLM en 2026

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èleQuel LLM répondmodel ou openrouter/auto
Routage fournisseurQuel hôte upstream sert ce modèleprovider — sélection pondérée par prix
FallbackBascule auto sur 429/5xxmodels + "route": "fallback"
Gratuit25+ 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 APIUne clé, 400+ modèlesCompte et clé par éditeur
Migration SDKDrop-in OpenAI (base_url)SDK natifs ou adaptateurs
Prix tokenTarif liste, sans markupTarif liste
Frais plateforme5,5 % crédits (min. 0,80 USD)Aucun frais gateway
FailoverIntégréRetries à implémenter
Fonctions exclusivesSous-ensembleBatch OpenAI, cache Anthropic, Vertex …
Latence+10–80 msDirect région fournisseur
Cas idéalMulti-modèles, prototype, <~10k USD/moisVolume 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

  1. Créer un compte sur openrouter.ai (SSO GitHub/Google).
  2. Keys → Create Key ; nommer par environnement (dev-mac-sandbox).
  3. Plafond de crédits sur la clé si billing partagé.
  4. Exporter : export OPENROUTER_API_KEY="sk-or-..." — jamais dans Git.
  5. Crédits optionnels (10 USD min pour quotas free élevés) ; crypto +5 %.
  6. Requête test curl avant Cursor, LangChain ou OpenClaw.
  7. 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 payantsPrix liste fournisseurSans markup OpenRouter
Achat crédits5,5 % (min. 0,80 USD)À la recharge
Crypto+5 %En plus des frais crédits
BYOK0 USD — 1 M req/moisPuis 5 % équivalent
Modèles gratuits0 USD tokens50/j default ; 1 000/j après 10 USD

08 · Checklist de validation en cinq points

  1. Machine isolée : clé jetable, curl sur trois IDs (GPT, Claude, Gemini).
  2. SDK OpenAI → base_url=https://openrouter.ai/api/v1 ; schéma identique.
  3. stream: true — mesurer TTFT vs baseline directe.
  4. Poster JSON fallback ; simuler échec — vérifier la chaîne.
  5. 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