Guide OpenRouter API : une API pour l'IA de pointe

Une clé API, un endpoint, des centaines de modèles de langage. C'est la promesse de l'API OpenRouter — et comme elle parle le schéma OpenAI, la plupart des applications peuvent l'adopter en changeant simplement la base URL. Ce guide vous emmène de zéro jusqu'à des appels prêts pour la production.

Ce que vous allez apprendre :

• Créer une clé et envoyer votre première requête avec curl, Python et TypeScript

• Lire les slugs de modèles (vendor/model) et utiliser des variantes comme :free, :nitro et :floor

• Gérer le streaming, les limites de débit et les fallbacks multi-modèles

• Savoir ce que coûte la plateforme — et quand une passerelle multimodale est un meilleur choix

Points clés

• OpenRouter propose une seule clé API et un seul endpoint compatible OpenAI pour des centaines de modèles : la plupart des applications l'adoptent en remplaçant la base URL par https://openrouter.ai/api/v1.
• Les identifiants de modèle suivent le format de slug vendor/model-name, et les suffixes :free, :nitro et :floor sont des indications de routage qui modifient le choix du fournisseur, pas les poids du modèle.
• L'inférence est facturée au prix catalogue du fournisseur sans majoration, mais l'achat de crédits coûte 5,5 % (minimum 0,80 $), et les modèles gratuits sont limités à 50 requêtes/jour, ou 1 000/jour après 10 $ ou plus d'achats.
• Le streaming utilise "stream": true avec des server-sent events, les réponses 429 doivent déclencher un backoff exponentiel, et un tableau models ordonné permet au routeur de réessayer côté serveur avec le modèle suivant en cas d'erreur ou de limite de débit.
• OpenRouter n'unifie que les modèles de texte ; APIMart applique le même principe d'une clé unique compatible OpenAI à plus de 500 modèles de chat, d'image, de vidéo et d'audio, à environ 20 % sous les prix officiels.

À lire aussi : Tarifs OpenRouter : crédits, frais et coûts ; OpenRouter ou API directes : que choisir ?

Comment fonctionne OpenRouter

Le catalogue de modèles

OpenRouter référence des centaines de modèles d'OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, Qwen et d'autres, chacun avec sa tarification au token et ses spécifications de contexte sur sa page modèle ^[1].

Le parcours d'une requête

Votre requête atteint l'endpoint unifié, le routeur choisit un fournisseur upstream pour ce modèle (beaucoup en ont plusieurs), l'exécute, puis normalise la réponse au format OpenAI. Par défaut, la sélection du fournisseur équilibre prix et disponibilité ^[2].

Ce que ça coûte

L'inférence est facturée au prix catalogue du fournisseur sans majoration ; la plateforme prélève 5.5% (min. $0.80) à l'achat de crédits, et les modèles gratuits sont plafonnés à 50 requêtes/jour (1,000/jour dès que vous avez acheté $10+ de crédits) ^[3].

Démarrage rapide

1. Créer un compte et une clé

Inscrivez-vous, achetez un petit pack de crédits (cela débloque aussi la limite gratuite supérieure) et générez une clé depuis le dashboard. Les clés sont des bearer tokens — gardez-les côté serveur.

2. Première requête avec curl

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.2",
    "messages": [{"role": "user", "content": "Hello from the unified API"}]
  }'

3. Python et TypeScript

Les SDK officiels OpenAI fonctionnent tels quels :

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-...",
)

resp = client.chat.completions.create(
    model="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Three taglines for a coffee app"}],
)

import OpenAI from "openai";

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

Slugs de modèles et variantes

Lire un slug

Les ID de modèles suivent le format vendor/model-name, par exemple anthropic/claude-sonnet-4.5 ou deepseek/deepseek-chat. La chaîne exacte affichée sur la page du modèle est exactement celle que l'API attend.

Les variantes en suffixe

Les variantes sont des indications de routage, pas des poids différents — même modèle, sélection de fournisseur différente ^[2].

Choisir un modèle

Filtrez le catalogue par prix, fenêtre de contexte et modalité, puis évaluez sur votre propre tâche. L'échelle pragmatique : prototyper sur une variante :free, lancer sur un modèle de milieu de gamme, garder un modèle frontier pour les 10% de requêtes les plus difficiles.

Enjeux de production

Streaming

Passez "stream": true et consommez les server-sent events — identique au contrat de streaming d'OpenAI, votre code d'UI de streaming existant fonctionne donc sans modification.

Limites de débit et retries

Les limites évoluent avec votre solde de crédits plutôt que par paliers fixes ; les 429 doivent déclencher un backoff exponentiel. Pour les modèles gratuits, prévoyez autour des plafonds de 50/1,000 par jour ^[3].

Fallbacks

Passez un tableau models classé par priorité et le routeur réessaie le modèle suivant côté serveur en cas d'erreur ou de limite de débit ^[4] :

{
  "model": "openai/gpt-5.2",
  "models": ["anthropic/claude-sonnet-4.5", "deepseek/deepseek-chat"],
  "messages": [{ "role": "user", "content": "..." }]
}

Quand il vous faut plus que des modèles de langage

OpenRouter unifie le texte. Dès que votre roadmap dit « générer une image produit » ou « ajouter un clip vidéo », vous revenez aux intégrations par fournisseur — sauf si votre passerelle couvre nativement ces modalités.

Une API unifiée qui inclut les modèles média

APIMart applique le même principe d'une clé unique à 500+ modèles : chat, image (GPT-Image-2), vidéo (Kling, Veo) et audio (Suno).

Des prix sous le tarif officiel, pas au tarif officiel

Les modèles sont proposés environ 20% sous les prix officiels, avec les tarifs d'origine et remisés de chaque modèle publiés sur la page de tarifs — aucun calcul de frais séparé n'est nécessaire.

Compatible avec le même code

Les endpoints sont compatibles OpenAI : le démarrage rapide ci-dessus fonctionne avec une autre base URL et une autre clé. Votre registre de modèles et votre logique de fallback se transfèrent sans rien toucher.

Accédez à 500+ modèles d'IA avec une seule clé API

Modèles de chat, d'image, de vidéo et d'audio derrière une seule API compatible OpenAI — tarification pay-as-you-go transparente, environ 20% sous les prix officiels.

Commencer à créer

Récapitulatif

Pointez un SDK OpenAI vers l'endpoint unifié, référencez les modèles par leur slug vendor/model, utilisez :floor ou :nitro quand le coût ou la vitesse compte, ajoutez un tableau de fallback models avant la production, et rappelez-vous que le coût réel est le prix catalogue plus les 5.5% de frais de rechargement ^[3]. Si votre application a aussi besoin d'images, de vidéo ou d'audio, partez d'une passerelle qui les couvre déjà.