OpenRouter majore-t-il les prix des tokens ?

Aucune majoration par token. OpenRouter transmet les tarifs fournisseurs sans modification. Les revenus proviennent d'une commission de 5,5 % sur les achats de crédits. Le mode BYOK offre 1 million de requêtes routées gratuites par mois.

OpenRouter est-il adapté à la production ?

OpenRouter est largement utilisé en production pour les agents. Stockez les clés côté serveur, définissez des plafonds de dépenses et recourez au BYOK ou aux API directes pour les charges sensibles. Le routage ajoute 10 à 80 ms de latence par rapport aux appels directs.

Quelle différence avec l'API OpenAI ?

OpenRouter est une passerelle unifiée vers 70+ fournisseurs et 400+ modèles via un endpoint compatible OpenAI. Vous envoyez vos requêtes à openrouter.ai/api/v1 avec des identifiants comme anthropic/claude-sonnet-4 au lieu de gérer des clés séparées.

Puis-je utiliser le SDK Python OpenAI avec OpenRouter ?

Oui. Définissez base_url sur https://openrouter.ai/api/v1 et passez votre clé OpenRouter. Le code existant du SDK OpenAI fonctionne en modifiant uniquement l'URL de base et le nom du modèle.

Guide OpenRouter API 2026 : GPT, Claude, Gemini et 400+ modèles avec une seule clé

Q: OpenRouter est-il gratuit ?

OpenRouter propose 25+ modèles gratuits avec 50 requêtes par jour sans achat. Après un crédit unique de 10 $, la limite passe à 1 000 requêtes par jour. Les modèles payants sont facturés au tarif fournisseur plus 5,5 % de frais sur les rechargements.

Q: Quand éviter OpenRouter ?

Évitez la passerelle pour une latence inférieure à 10 ms, des volumes de tokens très élevés où les 5,5 % deviennent significatifs, des exigences de conformité strictes ou des fonctionnalités spécifiques comme l'API Assistants d'OpenAI.

Synthèse : Gérer des clés API distinctes pour OpenAI, Anthropic, Google et DeepSeek multiplie les tableaux de bord, les quotas et la logique de reprise. OpenRouter unifie l'accès à plus de 400 modèles via un endpoint compatible OpenAI et une seule clé. Ce guide couvre la définition du service, le mécanisme de routage, un tableau comparatif avec les API directes, les avantages décisifs, les cas d'usage à éviter, la configuration en trois étapes, des exemples de code production (curl, Python, Node, SDK OpenAI), le streaming et le fallback, la tarification (5,5 %, BYOK) ainsi qu'une FAQ complète.

L'essentiel en 30 secondes

Définition	Passerelle LLM unifiée : 70+ fournisseurs, 400+ modèles, endpoint `/v1` compatible OpenAI
Endpoint	`https://openrouter.ai/api/v1/chat/completions`
Tarification	Aucune majoration token ; 5,5 % sur rechargement ; 25+ modèles gratuits
Offre gratuite	50 req/jour sans achat ; 1 000/jour après crédit de 10 $
Latence	10–80 ms de surcharge de routage vs API directe

1. Qu'est-ce qu'OpenRouter ?

OpenRouter est une passerelle API LLM unifiée. Plutôt que de vous inscrire séparément auprès d'OpenAI, Anthropic, Google, Meta, Mistral et DeepSeek, vous adressez l'ensemble de vos requêtes à un unique endpoint compatible OpenAI. OpenRouter gère l'authentification, la sélection du fournisseur, la reprise sur panne et la facturation.

Concepts fondamentaux :

Endpoint : https://openrouter.ai/api/v1 — remplacement direct de l'URL de base OpenAI
Authentification : Une clé API dans l'en-tête Authorization: Bearer
Nommage des modèles : format fournisseur/model-id — ex. openai/gpt-4o, anthropic/claude-sonnet-4, google/gemini-2.5-pro
Compatibilité : curl, Python requests, Node fetch et SDK OpenAI officiel — seuls base_url et model changent

Mécanisme de routage

Couche	Rôle	Exemple
Routage modèle	Vous spécifiez l'ID ; OpenRouter sélectionne le meilleur fournisseur disponible	`deepseek/deepseek-chat`
Routage fournisseur	Un même modèle peut tourner sur plusieurs hôtes ; sélection par prix, latence, disponibilité	DeepSeek via Fireworks ou en direct
Fallback	Nouvelle tentative automatique sur un modèle de secours en cas de 429/5xx	Claude principal, GPT-4o en repli
Modèles gratuits	25+ modèles à 0 $ ; quotas journaliers selon le niveau du compte	`meta-llama/llama-3.3-70b-instruct:free`

2. OpenRouter vs API directe : tableau comparatif

Dimension	OpenRouter	API fournisseur directe
Clés API	Une clé pour tous les fournisseurs	Clé distincte par éditeur
Modifications SDK	Changement de `base_url` uniquement	SDK ou endpoints propres à chaque éditeur
Changement de modèle	Modifier la chaîne modèle en une ligne	Nouveau compte, facturation et quotas
Reprise sur panne	Fallback intégré modèles/fournisseurs	Logique de retry personnalisée requise
Prix des tokens	Tarif catalogue fournisseur (sans majoration)	Tarif catalogue fournisseur
Frais plateforme	5,5 % sur les achats de crédits	Aucun
Latence	+10–80 ms de surcharge de routage	Minimale (accès direct)
Fonctionnalités éditeur	Sous-ensemble (pas d'Assistants API, cache limité)	Ensemble complet par éditeur
Conformité	Routage de données via tiers américain	DPA/BAA direct avec l'éditeur
Modèles gratuits	25+ modèles, limites journalières par palier	Offres gratuites spécifiques à chaque éditeur

3. Cinq raisons de choisir OpenRouter

Une clé, 400+ modèles. Prototyper avec GPT-4o, déployer avec DeepSeek V4 Flash, escalader vers Claude Opus — sans réauthentification ni nouveau compte de facturation.
Intégration transparente du SDK OpenAI. Les bases de code existantes appelant openai.chat.completions.create() fonctionnent en modifiant deux lignes : base_url et model.
Reprise sur panne intégrée. Les boucles d'agents déclenchent constamment des 429. Le routage fournisseur et le fallback réduisent des centaines de lignes de retry à un simple bloc JSON.
Données d'usage réelles. OpenRouter publie des classements hebdomadaires par tokens et dépenses — une base de décision production, pas du bruit de benchmarks. Consultez notre analyse des classements de juin 2026.
Offre gratuite pour la validation. 25+ modèles gratuits, 50 requêtes/jour (1 000/jour après un crédit de 10 $) pour valider vos workflows d'agents avant l'inférence payante.

4. Quand ne pas utiliser OpenRouter

OpenRouter n'est pas toujours le choix optimal. Contournez la passerelle lorsque :

Latence critique : la surcharge de 10–80 ms pèse pour la voix, le code en temps réel ou un TTFT inférieur à 100 ms.
Volume de tokens très élevé : à des millions de tokens par jour, les 5,5 % sur crédits deviennent significatifs. Les contrats directs peuvent être plus avantageux.
Conformité stricte : HIPAA, RGPD avec DPA spécifiques ou règles de résidence des données interdisant le routage par un tiers.
Fonctionnalités propriétaires : Assistants OpenAI, prompt caching Anthropic avec taux garantis, grounding Vertex — nécessitent le SDK natif.

5. Configuration : obtenir votre clé API OpenRouter

Étape 1 — Inscription

Rendez-vous sur openrouter.ai et connectez-vous via Google, GitHub ou e-mail. Aucune carte bancaire requise pour les modèles gratuits.

Étape 2 — Créer une clé API

Dans le tableau de bord, accédez à Keys, cliquez sur Create Key, nommez-la (ex. prod-agent) et copiez-la immédiatement. Conservez-la dans une variable d'environnement — ne la commitez jamais.

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

Étape 3 — Première requête

Vérifiez la clé avec un appel curl minimal. Vous devriez recevoir une réponse JSON contenant choices[0].message.content.

6. 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" \
  -H "HTTP-Referer: https://macgpu.com" \
  -H "X-Title: MACGPU Blog Demo" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "messages": [{"role": "user", "content": "Expliquez OpenRouter en une phrase."}]
  }'

6.2 Python (requests)

import os, requests

resp = requests.post(
    "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-flash",
        "messages": [{"role": "user", "content": "Bonjour depuis Python"}],
    },
)
print(resp.json()["choices"][0]["message"]["content"])

6.3 Python (SDK OpenAI)

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="openai/gpt-4o",
    messages=[{"role": "user", "content": "Test SDK drop-in"}],
)
print(completion.choices[0].message.content)

6.4 Node.js (SDK OpenAI)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

const res = await client.chat.completions.create({
  model: "deepseek/deepseek-chat",
  messages: [{ role: "user", content: "Node.js via OpenRouter" }],
});
console.log(res.choices[0].message.content);

6.5 Streaming

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

stream = client.chat.completions.create(
    model="anthropic/claude-sonnet-4",
    messages=[{"role": "user", "content": "Diffusez cette réponse."}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

6.6 Configuration du fallback

{
  "model": "anthropic/claude-sonnet-4",
  "models": [
    "anthropic/claude-sonnet-4",
    "openai/gpt-4o",
    "google/gemini-2.5-flash"
  ],
  "messages": [{"role": "user", "content": "Tâche agent avec reprise"}]
}

Le tableau models indique à OpenRouter d'essayer chaque modèle dans l'ordre si le précédent renvoie une erreur ou un rate limit. Pattern de reprise le plus simple pour les boucles d'agents en production.

6.7 Lister les modèles disponibles

curl -s https://openrouter.ai/api/v1/models \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  | python3 -m json.tool | head -80

7. Streaming, fallback et maîtrise des coûts

Streaming : définissez "stream": true dans le corps de la requête. OpenRouter transmet les chunks SSE au format OpenAI. Indispensable pour les interfaces de chat et les boucles d'outils où le time-to-first-token compte.

Fallback : utilisez le tableau models pour la reprise au niveau modèle. Pour le routage fournisseur, OpenRouter sélectionne automatiquement l'option la plus rapide ou la moins chère, sauf épinglage via les préférences provider du tableau de bord.

Maîtrise des coûts : définissez des plafonds de dépenses dans le tableau de bord. Réservez Claude Opus et GPT-4o à l'escalade ; employez DeepSeek V4 Flash ou Gemini Flash pour les brouillons. Surveillez les dépenses hebdomadaires dans l'onglet Activity.

8. Tarification : offre gratuite, 5,5 % et BYOK

Niveau	Détails
Modèles gratuits	25+ modèles à 0 $/token ; 50 req/jour sans achat ; 1 000/jour après rechargement de 10 $
Modèles payants	Tarif catalogue fournisseur, sans majoration par token
Frais plateforme	5,5 % sur les achats de crédits (pas sur l'usage token lui-même)
BYOK	Apportez votre clé fournisseur ; 1 M req routées gratuites/mois, puis faible frais de dépassement

Exemple : un crédit de 100 $ coûte 105,50 $ au total. Ces 100 $ achètent des tokens aux tarifs fournisseurs. À 10 M tokens/jour, les 5,5 % deviennent significatifs — évaluez les contrats directs.

9. FAQ

Q : OpenRouter est-il gratuit ?
R : 25+ modèles gratuits, 50 requêtes/jour sans achat. Après un crédit de 10 $ : 1 000/jour. Modèles payants au tarif catalogue.

Q : OpenRouter majore-t-il les tokens ?
R : Aucune majoration par token. Commission de 5,5 % sur les rechargements uniquement. BYOK : 1 M requêtes routées gratuites/mois.

Q : OpenRouter convient-il à la production ?
R : Largement adopté pour les agents. Clés côté serveur, plafonds de dépenses, BYOK ou API directes pour la conformité.

Q : Différence avec l'API OpenAI ?
R : OpenRouter est une passerelle multi-fournisseurs. Un endpoint, 400+ modèles. L'API OpenAI ne couvre que les modèles OpenAI avec accès natif aux fonctionnalités.

Q : Le SDK Python OpenAI est-il compatible ?
R : Oui. base_url="https://openrouter.ai/api/v1" et clé OpenRouter — aucune autre modification.

Q : Quand éviter OpenRouter ?
R : Latence inférieure à 10 ms, volume très élevé (5,5 %), conformité stricte ou fonctionnalités comme l'API Assistants.

10. Conclusion : développement OpenRouter sur Mac — externaliser les tests d'agents

L'intégration OpenRouter fonctionne sur tout système. Toutefois, si vous exécutez Cursor, Claude Code et OpenClaw avec des chaînes de fallback multi-modèles, votre Mac principal devient un goulot d'étranglement : sandboxes Docker, boucles d'agents et jobs batch à long contexte rivalisent pour la mémoire unifiée.

Approche recommandée : conservez la revue Cursor et les appels API légers sur votre portable ; externalisez les tests de charge d'agents, les sondes de routage OpenRouter et les tâches cron Gateway 24/7 vers un nœud Mac mini M4 distant MACGPU. Isolation SSH, location à la demande, validation MLX Metal en parallèle.