OpenRouter API : guide complet pour intégrer GPT, Claude et Gemini (2026)

OpenRouter agrège les capacités LLM de multiples éditeurs derrière une clé API et un endpoint compatible OpenAI, évitant l'intégration séparée chez OpenAI, Anthropic, Google, Meta ou DeepSeek.

• Endpoint : https://openrouter.ai/api/v1/chat/completions
• Authentification : Authorization: Bearer $OPENROUTER_API_KEY
• Protocole : format OpenAI Chat Completions — le SDK OpenAI existant ne change que base_url et api_key
• Nommage des modèles : fournisseur/modèle, ex. openai/gpt-4o, anthropic/claude-3.5-sonnet, google/gemini-2.5-pro

La plateforme opère deux décisions de routage indépendantes, fondamentales pour la résilience :

• Bascule automatique : en cas de 429/5xx, passage au fournisseur ou modèle suivant via le tableau models.
• Modèles gratuits : 25+ modèles ; 50 requêtes/jour sans crédit, 1000/jour après recharge ≥10 $ (20/min).
• Tarification : prix token au tarif fournisseur ; recharge 5,5 % (min. 0,80 $) ; crypto +5 % ; BYOK : 1 M req/mois gratuites, puis 5 %.

• Fragmentation des comptes : chaque éditeur impose sa propre inscription, rotation de clés et facturation.
• Changement de modèle = refonte d'intégration : formats de messages, streaming et codes d'erreur divergents.
• Point de défaillance unique : un fournisseur en rate limit fait échouer l'expérience utilisateur sans fallback intégré.
• Opacité des coûts : cinq dashboards empêchent une vue unifiée TTFT, débit et dépenses.

Pour les workflows créatifs multi-modèles et le prototypage rapide sur Apple Silicon, OpenRouter simplifie la stack ; pour un modèle unique à très haut volume ou des exigences de résidence stricte, l'API directe reste pertinente.

• Une clé, tous les modèles : changer de modèle = modifier la chaîne model.
• Failover cross-fournisseur : chaîne models avec bascule séquentielle.
• Facturation unifiée : un dashboard pour tokens, coûts, TTFT et débit.
• Pas de majoration token : seulement 5,5 % à la recharge ; BYOK pour réduire à l'échelle.
• Périmètre clair : comparaison de modèles, agents, budget mensuel modéré.

Préférez l'API directe lorsque :

• Volume mensuel à cinq chiffres USD sur un seul modèle
• Besoin de Prompt Caching Anthropic, Batch OpenAI ou outils Vertex Google
• Latence critique : +10–80 ms inacceptable pour votre UX
• Données sensibles : le trafic ne doit pas transiter par une tierce US

1. Créer un compte : openrouter.ai via GitHub ou e-mail.
2. Générer une clé API : page Keys ; en production, une clé par projet avec spend limit.
3. Variable d'environnement : export OPENROUTER_API_KEY="sk-or-..." — ne jamais committer la clé.
4. Première requête : curl ou SDK OpenAI ; vérifier HTTP 200 et ID modèle.
5. Lister les modèles : curl https://openrouter.ai/api/v1/models -H "Authorization: Bearer $OPENROUTER_API_KEY"
6. Mise en production : chaîne fallback, streaming, en-têtes HTTP-Referer/X-Title, clé sur un hôte agent 7×24.

Snippets prêts à l'emploi après remplacement de la clé.

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": "Expliquez l'informatique quantique en une phrase"}]
  }'

Python (requests)

import requests, os
r = requests.post(
  "https://openrouter.ai/api/v1/chat/completions",
  headers={"Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}"},
  json={"model": "google/gemini-2.5-pro",
        "messages": [{"role": "user", "content": "Implémentez quicksort en Python"}]}
)
print(r.json()["choices"][0]["message"]["content"])

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": "Hello!"}],
  extra_headers={"HTTP-Referer": "https://jexcloud.com", "X-Title": "JEXCLOUD Demo"},
)

Node.js (SDK OpenAI)

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" }],
});

Streaming

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

JSON fallback multi-modèles

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

• Échelle : 70+ fournisseurs, 400+ modèles (vérifier via /models).
• Gratuit : 25+ modèles ; 50 req/jour sans crédit, 1000/jour après 10 $, plafond 20/min.
• Frais : recharge 5,5 % (min. 0,80 $) ; crypto +5 % ; BYOK 1 M req/mois gratuites.
• Latence : +10–80 ms via passerelle — mesurer TTFT en conditions réelles.
• Contrôle des coûts : modèles Flash par défaut ; Opus pour étapes critiques ; spend limits par projet.

OpenRouter ne majore pas le prix token — le calcul total inclut frais de recharge, latence passerelle et conformité, pas un coefficient opaque.

OpenRouter est-il payant ? Modèles gratuits et payants ; payant au tarif fournisseur, recharge 5,5 %.

Disponible en France / UE ? API accessible ; évaluer conformité RGPD et flux de données.

Quels modèles ? 400+ au format vendor/model ; liste via /api/v1/models.

OpenRouter ou Claude direct ? Multi-modèles et fallback : OpenRouter ; fonctions exclusives et gros volume : direct.

Coût mensuel ? Variable — agents Flash souvent dizaines de dollars, charge Opus peut atteindre milliers.

Sécurité ? Trafic via passerelle ; données sensibles : BYOK ou API directe.

Appel Python ? Section 05 — requests ou SDK OpenAI.

P0 — Crawl et indexation :

• CDN/WAF bloque Googlebot — tester via Search Console
• hreflang manquant — Google ne retient qu'une version canonique
• robots.txt / noindex sur /en/
• sitemap sans URLs par langue ou balises alternate
• HTML CSR vide pour les crawlers

Contenu :

• Traduction littérale au lieu de requêtes natives (OpenRouter vs OpenAI API)
• Pas de recherche mots-clés anglais ; E-E-A-T faible

Autorité :

• Distribution chinoise avec backlinks ; pages anglaises sans Reddit, HN, dev.to

1. GSC : URL anglaise indexée ?
2. CDN/WAF vs Googlebot
3. hreflang, canonical, sitemap multilingue
4. 3–5 articles anglais réécrits (pas traduits)
5. Première distribution dev.to, Reddit, Hacker News

Français : OpenRouter API, tutoriel OpenRouter, OpenRouter vs OpenAI ; longue traîne : tarification, modèles gratuits, exemple Python.

Anglais : OpenRouter API tutorial, is OpenRouter worth it, fallback routing, streaming response.

Signaux titre FR : guide complet, étape par étape, 2026 — mot-clé dans titre, intro et H2.

Principe : exemples de code partagés ; titres, intros, H2 et FAQ réécrits par langue ; meta description 120–160 caractères.

Structure URL (sous-répertoire, autorité partagée) :

https://jexcloud.com/fr/blog/2026-0724-openrouter-api-tutorial-gpt-claude-gemini-guide.html
https://jexcloud.com/en/blog/2026-0724-openrouter-api-tutorial-gpt-claude-gemini-guide.html

hreflang (références croisées + x-default) :

<link rel="alternate" hreflang="fr" href="https://jexcloud.com/fr/blog/..." />
<link rel="alternate" hreflang="en" href="https://jexcloud.com/en/blog/..." />
<link rel="alternate" hreflang="x-default" href="https://jexcloud.com/en/blog/..." />

Canonical par langue vers elle-même ; sitemap avec xhtml:link alternate.

Schema : BlogPosting + FAQPage ; questions FAQ dans la langue cible.

Distribution FR : LinkedIn, Medium FR, dev.to avec canonical ; EN : dev.to, HN, Reddit.

P0 : GSC index → CDN/WAF → hreflang/canonical/sitemap.

P1 : articles localisés → mots-clés → Schema Article + FAQPage.

P2 : distribution → sitemap GSC → impressions/CTR par chemin linguistique.

Un Mac personnel fermé interrompt les agents OpenRouter. Un VPS surchargé sans macOS natif : jitter SSH casse les boucles multi-outils. Machines partagées : rotation de clés et versions CLI divergentes — problèmes de production indépendants de l'intégration API.

Pour les équipes qui font tourner Cursor Agent, OpenClaw Gateway et le routage OpenRouter 7×24 sur du matériel Apple, JEXCLOUD Mac bare metal multi-région offre Apple Silicon dédié, macOS authentique, livraison en 120 secondes, facturation mensuelle flexible. Coûts modèles via OpenRouter, compute via bare metal. Détails : page tarifs, onboarding : centre d'aide.