# OpenRouter — des dizaines de LLM via une seule clé API

OpenRouter : accéder à Claude, GPT, Gemini et Mistral via une seule clé API compatible OpenAI. Configuration, exemples Python, données cloud et clé API.

URL canonique : https://www.osfria.fr/openrouter.html

---

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.

### Fiabilité & transparence

🟢 **Fiable et activement maintenu**

- **Maintenance** : service cloud géré, catalogue en permanence mis à jour (300+ modèles, 60+ fournisseurs en juin 2026) ; pas de logiciel à maintenir côté utilisateur — les mises à jour sont transparentes, le service est opérationnel avec un historique de quelques coupures courtes (35-50 min) sur 8 mois.
- **Adoption** : passerelle multi-modèles cloud de référence pour les développeurs ; intégrée nativement dans Open WebUI, LibreChat, Perplexica et de nombreux outils IA ; très utilisée pour comparer des modèles à moindre coût.
- **Sécurité** : service américain — vos requêtes transitent par OpenRouter puis le fournisseur du modèle ; pas de journalisation des prompts par défaut, mais les endpoints `:free` peuvent router vers des fournisseurs s'entraînant sur les entrées — vérifiez les réglages de données avant d'envoyer du contenu sensible.
- **Verdict** : complément cloud idéal pour accéder ponctuellement à des modèles propriétaires de pointe ; pas adapté aux données confidentielles ni aux usages nécessitant une garantie de disponibilité (pas de SLA formel).

> 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](https://www.osfria.fr/open-webui.html), LibreChat, [Perplexica](https://www.osfria.fr/perplexica.html)…). 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](https://www.osfria.fr/ollama.html) 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](https://www.osfria.fr/ollama.html).

### 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](https://www.osfria.fr/open-webui.html), 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](https://www.osfria.fr/ollama.html) — l'alternative 100 % locale pour les modèles open source.
- [Open WebUI](https://www.osfria.fr/open-webui.html) — interface graphique qui se branche sur OpenRouter.
- [Perplexica](https://www.osfria.fr/perplexica.html) — recherche IA pouvant utiliser OpenRouter comme LLM.
- [IA locale vs cloud](https://www.osfria.fr/ia-locale.html) — quand rester local, quand passer par un service.

### Sources

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