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

Dans un studio où Final Cut Pro, DaVinci Resolve et des pipelines d'agents coexistent sur le même Mac Studio, multiplier les comptes OpenAI, Anthropic et Google devient un frein invisible : facturation éclatée, clés éparpillées, et personne ne sait quel modèle a rédigé la dernière version du brief client. OpenRouter unifie plus de 400 modèles derrière un endpoint compatible OpenAI. Ce guide est rédigé indépendamment en français — ton professionnel, comparaison lucide avec les API directes, exemples exécutables, et une perspective matérielle Apple pour les équipes créatives qui veulent des agents fiables sans sacrifier l'esthétique de leur stack macOS.

1. Qu'est-ce qu'OpenRouter ?

En bref : OpenRouter est une passerelle LLM unifiée. Vous adressez vos requêtes à https://openrouter.ai/api/v1/chat/completions avec Authorization: Bearer $OPENROUTER_API_KEY, indiquez un slug comme anthropic/claude-sonnet-4 ou openai/gpt-4o, et la passerelle achemine vers le fournisseur sous-jacent. Le format request/response suit OpenAI Chat Completions — votre code existant ne demande en général qu'un nouveau base_url et une nouvelle clé.

À chaque requête, deux décisions de routage interviennent. Le routage modèle est piloté par le champ model — ou openrouter/auto pour laisser la passerelle choisir. Le routage fournisseur sélectionne l'infrastructure qui sert ce modèle ; par défaut, OpenRouter favorise prix et disponibilité. En cas de rate limit ou d'erreur 5xx, bascule automatique vers un autre fournisseur ou un modèle de secours dans votre tableau models.

Les identifiants suivent fournisseur/modèle. Exemples juillet 2026 : openai/gpt-4o, anthropic/claude-sonnet-4, google/gemini-2.5-pro, deepseek/deepseek-chat. Catalogue live : GET /api/v1/models. Pour l'allocation réelle des dépenses, voir notre guide classement hebdomadaire et le classement CLI OpenRouter.

2. OpenRouter vs API directe (OpenAI, Anthropic, Google)

OpenRouter n'abolit pas tout contrat enterprise — c'est une couche de consolidation pour les équipes qui comparent des modèles chaque semaine, orchestrent des agents multi-modèles ou souhaitent un failover intégré. Le tableau ci-dessous encadre la décision que posent les lead tech des agences et des studios.

3. Cinq raisons de basculer vers OpenRouter

1. Une clé ouvre tous les modèles frontier. Fini les intégrations parallèles pour chaque fournisseur — l'onboarding d'un nouveau monteur ou développeur se résume à une variable d'environnement.
2. Migration quasi nulle depuis le code OpenAI. Pointez le SDK, changez la clé et le slug modèle ; messages, tool calls et streaming restent intacts.
3. Failover automatique. Les rate limits et 5xx transitoires — fréquents lors de rendus nocturnes automatisés — sont absorbés avant votre application.
4. Facturation et latence unifiées. Un seul endroit pour comparer dépenses et time-to-first-token sur les modèles réellement utilisés en production créative.
5. Pas de markup token et tier gratuit utilisable. Benchmarker Claude contre Gemini sur le même prompt de direction artistique sans ouvrir trois portails fournisseurs.

4. Quand ne pas utiliser OpenRouter

• Économies d'échelle mono-fournisseur. Au-delà de dizaines de milliers USD/mois sur un seul modèle, les frais de crédit et la latence passerelle peuvent dépasser un contrat enterprise direct.
• Fonctionnalités exclusives. Batch API OpenAI, facturation Prompt Caching Anthropic, outils Vertex Google — réservés aux plans natifs.
• Résidence stricte des données. Données clients sensibles soumises à RGPD sectoriel : API directes avec DPA ou modèles self-hosted.
• Latence temps réel critique. Boucles sub-100 ms : benchmarker d'abord les endpoints directs.
• Modèles preview à politique de rétention floue. Ne pas router des briefs confidentiels sans revue compliance.

5. Obtenir votre clé API OpenRouter — pas à pas

1. Créer un compte sur openrouter.ai. E-mail ou OAuth suffisent.
2. Paramètres → Keys → Create Key. Nommer par environnement — prod-studio-agent, local-dev.
3. Copier la clé immédiatement. Préfixe sk-or-, affichage unique. Stocker dans un gestionnaire de mots de passe ou OPENROUTER_API_KEY.
4. Crédits pour modèles payants. Le tier gratuit fonctionne sans solde ; les slugs payants exigent un solde. Frais de traitement 5,5 % à l'achat.
5. Test de fumée :

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

curl -s https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Réponds exactement : OpenRouter OK"}]
  }' | jq -r '.choices[0].message.content'

6. Exemples de code : cURL, Python, Node.js, SDK OpenAI

cURL

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://sftpmac.com" \
  -H "X-Title: SFTPMAC OpenRouter Demo" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "messages": [
      {"role": "user", "content": "Résume la théorie des couleurs en une phrase."}
    ]
  }'

Python (requests)

import os
import requests

response = requests.post(
    url="https://openrouter.ai/api/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}",
        "Content-Type": "application/json",
        "HTTP-Referer": "https://sftpmac.com",
        "X-Title": "SFTPMAC OpenRouter Demo",
    },
    json={
        "model": "google/gemini-2.5-pro",
        "messages": [
            {"role": "user", "content": "Propose trois titres pour un documentaire."}
        ],
    },
    timeout=60,
)
response.raise_for_status()
print(response.json()["choices"][0]["message"]["content"])

Node.js (SDK OpenAI)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
  defaultHeaders: {
    "HTTP-Referer": "https://sftpmac.com",
    "X-Title": "SFTPMAC OpenRouter Demo",
  },
});

const completion = await client.chat.completions.create({
  model: "deepseek/deepseek-chat",
  messages: [{ role: "user", content: "Explique OpenRouter en une phrase." }],
});

console.log(completion.choices[0].message.content);

Drop-in SDK OpenAI (Python)

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="openai/gpt-4o",
    messages=[{"role": "user", "content": "Bonjour depuis OpenRouter."}],
    extra_headers={
        "HTTP-Referer": "https://sftpmac.com",
        "X-Title": "SFTPMAC OpenRouter Demo",
    },
)
print(completion.choices[0].message.content)

7. Streaming, fallback et tarification 2026

Streaming

stream: true comme avec le SDK OpenAI natif ; OpenRouter transmet les événements server-sent du fournisseur upstream — idéal pour les interfaces de chat créatif où la réponse doit apparaître mot à mot.

const stream = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4",
  messages: [{ role: "user", content: "Écris un haiku sur l'automne." }],
  stream: true,
});

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

Chaîne de fallback

{
  "model": "anthropic/claude-sonnet-4",
  "models": [
    "anthropic/claude-sonnet-4",
    "openai/gpt-4o",
    "google/gemini-2.5-pro"
  ],
  "route": "fallback",
  "messages": [{ "role": "user", "content": "Résume ce brief client." }]
}

Tableau tarifaire 2026

8. Angle créatif : Apple Silicon, pipelines et agents nocturnes

L'industrie créative francophone investit massivement dans Mac Studio M4 Max et MacBook Pro M4 Pro — non par snobisme, mais parce que ProRes, Core Audio et les sandbox macOS offrent un cadre de confiance que les VPS Linux ne reproduisent pas pour les plugins propriétaires. OpenRouter s'intègre naturellement dans ce paysage : un agent OpenClaw sur le Mac du studio peut appeler Claude pour réécrire un script pendant qu'un second agent Gemini analyse des thumbnails, le tout via une seule clé OPENROUTER_API_KEY.

Le piège classique : utiliser le MacBook Pro du réalisateur comme gateway 24/7. La fermeture du capot interrompt les callbacks Slack ou Telegram mid-render. Le pattern professionnel — adopté par les boutiques motion et les agences IA — consiste à séparer la station créative du nœud agent : Mac mini M4 ou Mac Studio loué en remote, gateway sous launchd, workspace synchronisé en SFTP depuis la machine de montage. Vous conservez l'écosystème Apple natif sans sacrifier la disponibilité nocturne des automatisations de metadata, de traduction ou de QA script.

Pour les équipes qui comparent modèles avant un tournage ou une campagne, OpenRouter accélère les itérations : même prompt, slugs différents, facturation consolidée. Croisez avec notre classement CLI pour choisir l'outil terminal adapté à votre workflow Git ou NLE-adjacent.

9. FAQ

OpenRouter est-il gratuit ? Oui pour l'expérimentation : 25+ modèles, limites quotidiennes, ~50 req/jour sans solde.

Y a-t-il un markup token ? Non — 5,5 % uniquement à l'achat de crédits.

OpenRouter est-il sûr ? Agrégateur établi ; les prompts transitent leur infrastructure. Revue compliance avant données clients sensibles.

OpenRouter vs LiteLLM ? OpenRouter = gateway hébergé avec facturation. LiteLLM = proxy self-hosted. Zero ops → OpenRouter.

Changer de modèle sans réécrire l'app ? Modifier le slug model ; ajouter un tableau models pour la résilience.

10. Agents OpenRouter sur un Mac distant SFTPMAC

OpenRouter résout l'accès aux modèles — pas la disponibilité du gateway. Sleep, coupures VPN et processus tués produisent le même silence qu'une panne API.

Pattern production : Apple Silicon, Node 22, clé en SecretRef, slugs primary/fallback dans openclaw.json, gateway launchd, artefacts synchronisés en SFTP/rsync depuis le poste créatif. Incidents : santé gateway → probe channels → 429 OpenRouter → swap modèle.

SFTPMAC location Mac distant vise ce profil : permissions macOS natives, connectivité 24/7 pour callbacks messagerie, rollback APFS. Complétez avec guide installation OpenClaw et le classement hebdomadaire OpenRouter cité plus haut.