OSFRIA Découvrir les outils

OSIALab · Providers & passerelles

OpenRouter — des dizaines de LLM avec une seule clé API

OpenRouter centralise l'accès à de nombreux modèles de langage cloud (Claude, GPT, Gemini, Mistral, Llama…) derrière une API unique compatible OpenAI. Une clé, une facturation, un catalogue — pour comparer, basculer d'un modèle à l'autre, et ne pas multiplier les comptes.

Page informative, sans valeur de conseil. OpenRouter est un service tiers (société américaine), pas un logiciel local. Lisez ses conditions et sa politique de confidentialité avant d'y envoyer des données, et tarifs comme modèles évoluent : vérifiez sur openrouter.ai.

À quoi ça sert

OpenRouter joue le rôle de passerelle : au lieu d'une clé chez OpenAI, une chez Anthropic, une chez Google, etc., vous en créez une seule et accédez à l'ensemble. L'API suit le format OpenAI, ce qui permet de pointer vers OpenRouter sans réécrire le code des outils déjà prévus pour ce format (Open WebUI, LibreChat, Perplexica…). Le catalogue mêle modèles payants à l'usage et modèles gratuits (suffixe :free, avec quotas).

Ce qui fait sa force

  • Une seule intégration, tout le catalogue. API compatible OpenAI : on change de modèle en modifiant une chaîne de caractères, sans toucher au reste du code.
  • Comparer sur pied d'égalité. Soumettre la même tâche à Claude, GPT et Mistral depuis la même interface est immédiat — idéal pour choisir le bon modèle par cas d'usage.
  • Une facturation unifiée. Un seul crédit pour tous les fournisseurs, avec le détail du coût par requête. Pas de multiplier les abonnements.
  • Du repli et du routage. OpenRouter peut rediriger vers un fournisseur alternatif si l'un est indisponible, et offre des modèles :free pour tester sans frais (sous conditions de données, voir plus bas).
  • Le complément cloud du local. Là où Ollama couvre le 100 % local, OpenRouter donne accès ponctuel à des modèles propriétaires de pointe sans infrastructure.

Pour qui

Pour les développeurs et utilisateurs avancés qui veulent accéder facilement à plusieurs LLM cloud, comparer des modèles, ou compléter une chaîne locale par un modèle propriétaire ponctuel. Pour un usage strictement confidentiel ou hors-ligne, restez sur une solution locale comme Ollama.

Configuration

Créer une clé API

Sur openrouter.ai, créez un compte puis générez une clé (préfixe sk-or-v1-). Ajoutez des crédits pour les modèles payants ; les modèles :free fonctionnent sans crédit.

Appel via l'API (format OpenAI)

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistralai/mistral-7b-instruct",
    "messages": [{"role": "user", "content": "Bonjour, comment vas-tu ?"}]
  }'

En Python (SDK OpenAI)

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],   # clé lue depuis l'environnement
)

reponse = client.chat.completions.create(
    model="anthropic/claude-3.5-sonnet",
    messages=[{"role": "user", "content": "Explique l'IA locale en trois lignes."}],
)
print(reponse.choices[0].message.content)

Brancher Open WebUI

Dans Open WebUI, ajoutez une connexion de type OpenAI avec l'URL https://openrouter.ai/api/v1 et votre clé : les modèles OpenRouter apparaissent dans l'interface.

Points de vigilance

OpenRouter est un service cloud — clé API obligatoire, requêtes sortantes — pas un logiciel local. C'est un complément à l'IA locale pour accéder ponctuellement à des modèles propriétaires de pointe ; ce n'est pas un substitut pour les données sensibles ou un usage hors-ligne. Les vrais points portent sur les données transmises, la clé API et les modèles gratuits.

Point d'attention Niveau Ce qu'il faut savoir
Données transmises à un service cloud 🟡 à 🔴 selon les données Vos requêtes transitent par OpenRouter (États-Unis) puis vers le fournisseur du modèle. N'y envoyez pas de données personnelles sensibles, confidentielles ou couvertes par le secret professionnel. Pour ces cas, gardez un LLM local.
Modèles gratuits et entraînement sur vos données 🟡 spécifique aux endpoints :free OpenRouter ne journalise pas les prompts par défaut, mais certains endpoints — surtout les modèles :free — peuvent router vers des fournisseurs qui s'entraînent sur les entrées. Des réglages distincts existent pour autoriser ou non ce routage côté gratuit et côté payant : vérifiez-les avant d'envoyer quoi que ce soit de sensible.
Confidentialité de la clé API 🔴 facturation à la clé Une clé compromise, c'est de la consommation à vos frais. Stockez-la en variable d'environnement, jamais en clair dans le code ni dans un dépôt ; révoquez-la au moindre doute et fixez un plafond de dépenses.
Conditions propres à chaque fournisseur 🟡 variable selon le modèle OpenRouter relaie vers Anthropic, OpenAI, Google… chacun avec ses propres conditions et politiques de rétention. Le choix du modèle détermine en partie le traitement réel de vos données.

Sécurité

  • Ne committez jamais votre clé. Variables d'environnement ou gestionnaire de secrets ; un .env placé dans le .gitignore.
  • Fixez un plafond de dépenses dans les réglages du compte, et surveillez la consommation.
  • Révoquez les clés inutilisées et activez l'authentification à deux facteurs sur le compte.
  • Réglez les autorisations de données (entraînement, journalisation) selon votre sensibilité, en distinguant endpoints gratuits et payants.

Aller plus loin

  • Ollama — l'alternative 100 % locale pour les modèles open source.
  • Open WebUI — interface graphique qui se branche sur OpenRouter.
  • Perplexica — recherche IA pouvant utiliser OpenRouter comme LLM.
  • IA locale vs cloud — quand rester local, quand passer par un service.

Sources

  • Site officiel : openrouter.ai
  • Documentation API : openrouter.ai/docs
  • Catalogue de modèles : openrouter.ai/models
  • Politique de confidentialité & journalisation : à consulter sur openrouter.ai (service tiers, conditions évolutives)

Continuer la lecture