Guide OpenRouter API
Un seul accès pour GPT / Claude / Gemini (400+ modèles) + SEO bilingue FR/EN (2026)

Vous voulez appeler GPT-4o, Claude 3.5 Sonnet, Gemini 2.5 Pro et 400+ modèles avec une seule clé APIOpenRouter est la passerelle LLM unifiée. Ce guide s'adresse aux développeurs francophones et éditeurs de blogs bilingues : routage à deux niveaux, avantages, intégration en 6 étapes, code complet, Fallback/BYOK, diagnostic trafic EN, checklist SEO FR/EN.Mise à jour : 2026-07-24

01

Qu'est-ce qu'OpenRouter ? Passerelle unifiée GPT / Claude / Gemini

OpenRouter agrège 70+ fournisseurs et 400+ modèles via une clé + endpoint compatible OpenAI.

  • Endpoint : https://openrouter.ai/api/v1/chat/completions
  • Auth : Authorization: Bearer $OPENROUTER_API_KEY
  • Protocole : OpenAI Chat Completions — changez base_url et api_key
  • IDs : openai/gpt-4o, anthropic/claude-3.5-sonnet, etc.

Routage à deux niveaux : modèle + fournisseur

Deux décisions indépendantes structurent la valeur technique d'OpenRouter.

CoucheDécideContrôle
Model RoutingQuel modèle répondmodel / openrouter/auto
Provider RoutingQuel hébergeur traiteprovider ; pondération prix

Fallback automatique via models en cas de limite ou erreur fournisseur.

6 contraintes avant intégration

  1. 01

    Comptes fournisseurs fragmentés

  2. 02

    Pannes / rate limits

  3. 03

    Facturation dispersée

  4. 04

    Markup token des agrégateurs

  5. 05

    Latence +10–80 ms

  6. 06

    Couche intermédiaire US (conformité)

02

OpenRouter vs API directes OpenAI / Anthropic

CritèreOpenRouterAPI directe
ClésUne clé, 400+ modèlesComptes séparés
Migrationbase_url + api_keySDK différents
FailoverIntégréÀ coder
FacturationDashboard uniqueMultiple
Prix tokenSans markupTarif officiel
Latence+10–80 msMinimale
Fonctions exclusivesPas de Prompt CachingBatch, Assistants…

5 avantages clés

  1. 01

    Une clé, tous les modèles

  2. 02

    Failover cross-fournisseur

  3. 03

    Dashboard unifié

  4. 04

    Pas de markup (5,5 % recharge)

  5. 05

    25+ modèles gratuits

warning

À éviter si : volume énorme sur un modèle, Prompt Caching requis, latence critique, exigences strictes de résidence des données.

「OpenRouter n'est pas un remplacement des SDK officiels — c'est le compromis multi-modèles.」

03

Tutoriel : 6 étapes + exemples de code

  1. 01

    Inscription openrouter.ai

  2. 02

    Créer une clé API

  3. 03

    Crédits (optionnel)

  4. 04

    Première requête

  5. 05

    SDK OpenAI : base_url + api_key

  6. 06

    Production : Fallback + GET /api/v1/models

Requête cURL

bash
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": "Explain quantum computing in one sentence" }
    ]
  }'

Python (requests)

python
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": "Write a quicksort in Python"}],
    },
)
print(response.json()["choices"][0]["message"]["content"])

Python (OpenAI SDK)

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

Node.js (OpenAI SDK)

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

Streaming

javascript
const stream = await openai.chat.completions.create({
  model: "anthropic/claude-3.5-sonnet",
  messages: [{ role: "user", content: "Write a short poem about autumn" }],
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}

Configuration Fallback

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

Liste des modèles

bash
04

Fallback, modèles gratuits, coûts

Idéal pour prototypes, A/B, budgets modestes, haute disponibilité multi-modèles.

ItemDetails
Token unit pricePass-through; no token markup
Top-up fee5.5% (min $0.80); +5% crypto
Free models25+; ~50 req/day un funded; ≥$10 → 1000/day, 20/min
BYOKBring your vendor keys; first 1M req/month free, then 5% on equivalent spend
info

BYOK pour éviter les 5,5 % ; dev sur modèles gratuits ; modèles économiques en fin de chaîne Fallback.

05

SEO bilingue : pourquoi les pages EN sous-performent

Si vous maintenez un blog FR/EN en parallèle d'agents OpenRouter, voici le diagnostic priorisé :

P0 : crawl et index

  • CDN/WAF vs Googlebot
  • hreflang /fr/ ↔ /en/
  • robots/noindex
  • sitemap alternates
  • CSR → SSG

P1 : l'anglais doit être localisé

Pas de traduction mot à mot. Ciblez OpenRouter vs OpenAI API, is OpenRouter worth it.

FrançaisAnglais natif
tutoriel OpenRouterOpenRouter tutorial
différence OpenAIOpenRouter vs OpenAI API
tarifsis OpenRouter free
PythonOpenRouter Python example

Données structurées

BlogPosting + FAQPage JSON-LD.

Canaux de diffusion

Communautés FRFrançaisTutoriels
dev.toAnglaisCanonical
HN/RedditAnglaisCommunautés
GSCFR/ENSitemap

Checklist + suivi

  • P0 : index GSC + hreflang
  • P1 : contenus FR/EN distincts
  • P2 : dev.to + canaux locaux
  • KPI : Impressions/CTR par langue

Données EEAT

  • 70+ fournisseurs, 400+ modèles
  • +10–80 ms
  • 5,5 % ; BYOK 1M/mois
  • 50→1000 gratuits/jour

Pour des agents 24/7, SSH stable, builds iOS/macOS, NodeMini Mac Mini cloud offre du Apple Silicon dédié. Tarifs location.

FAQ

Questions fréquentes

Pas de markup token. 5,5 % à la recharge. 25+ modèles gratuits.

Oui via API ; évaluez latence et conformité RGPD.

70+/400+. openrouter.ai. Location Mac Mini.

PME/multi-modèle → OpenRouter. Volume/cache → direct.

SDK OpenAI, base_url + api_key.

Passerelle tierce. Centre d'aide.

Non — 5,5 % recharge uniquement.

Selon modèles ; typiquement dizaines à milliers USD.