Guide de la clé API OpenRouter

Clé API OpenRouter : l’obtenir et utiliser les modèles gratuits

Créez une clé API OpenRouter, voyez les limites des modèles gratuits, corrigez les erreurs 401, 402 et 429 et utilisez OpenRouter sur iPhone, Android ou le web.

Mis à jour le
  • Pour obtenir une clé API OpenRouter, connectez-vous sur openrouter.ai, ouvrez openrouter.ai/keys et créez une clé ; elle commence par « sk-or-v1- ». La création de la clé est gratuite, les modèles dont l’identifiant se termine par « :free » sont utilisables dans des limites quotidiennes, et tous les autres modèles se paient avec des crédits prépayés.
  • OpenRouter, c’est un seul compte et une seule clé pour des modèles de nombreuses entreprises d’IA. OpenRouter ne publie pas d’app de chat pour iPhone ou Android : sur téléphone, on passe par une app de chat qui accepte une clé OpenRouter, comme Oriveo.
  • Au 18 novembre 2026, les modèles gratuits autorisent 20 requêtes par minute et 50 par jour, ou 1 000 par jour une fois que vous avez acheté au moins 10 crédits. L’erreur 402 signifie que vous n’avez plus de crédits.
Oriveo sur iPhone : l’écran des fournisseurs, avec les fournisseurs que vous avez connectés et la dépense du mois.

Qu’est-ce qu’OpenRouter, et qu’est-ce qu’une clé API ?

OpenRouter est un service qui donne accès aux modèles de nombreuses entreprises d’IA avec un seul compte. Au lieu de vous inscrire chez chacune, vous ajoutez des crédits une seule fois sur OpenRouter et choisissez vos modèles dans sa liste.

Une clé API est le code secret qu’une app utilise pour envoyer des requêtes sur votre compte. OpenRouter vérifie la clé, transmet votre message au modèle choisi et déduit le coût de vos crédits OpenRouter.

OpenRouter est conçu pour les apps et les développeurs. Il ne publie pas sa propre app de chat pour iPhone ou Android, d’où les nombreuses recherches « app OpenRouter ». Ce qu’il vous faut en réalité, c’est une app de chat qui accepte une clé OpenRouter.

Comment obtenir une clé API OpenRouter ?

Cela prend deux minutes sur le site d’OpenRouter.

  • Rendez-vous sur openrouter.ai et créez un compte, ou connectez-vous.
  • Ouvrez la page des clés, openrouter.ai/keys, et créez une nouvelle clé. Donnez-lui le nom de l’app ou de l’appareil sur lequel vous l’utiliserez.
  • Copiez la clé. Les clés OpenRouter commencent par « sk-or-v1- » et comptent 73 caractères : vérifiez que vous l’avez copiée en entier.
  • Si vous voulez des modèles payants, ajoutez des crédits sur la page Credits.
  • Rangez la clé en lieu sûr, par exemple dans un gestionnaire de mots de passe. En cas de fuite, supprimez-la sur la page des clés et créez-en une nouvelle.

L’API OpenRouter est-elle gratuite ?

En partie. Créer un compte et une clé ne coûte rien, et OpenRouter propose des modèles gratuits dont l’identifiant se termine par « :free ». Tout le reste se paie avec des crédits prépayés. OpenRouter indique aussi que les nouveaux utilisateurs reçoivent un petit crédit gratuit, sans en préciser le montant.

Les modèles gratuits ont des limites. Voici celles publiées par OpenRouter au 18 novembre 2026 :

  • Si votre solde passe sous zéro, OpenRouter précise que même les modèles gratuits peuvent renvoyer des erreurs.
  • Le site d’OpenRouter indique quels modèles ont actuellement une version « :free » ; vérifiez-le avant de compter sur l’un d’eux.
L’API OpenRouter est-elle gratuite ?
Votre compteRequêtes par minute (modèles gratuits)Requêtes par jour (modèles gratuits)
Moins de 10 crédits achetés au total2050
Au moins 10 crédits achetés au total201 000

Comment fonctionnent les crédits OpenRouter ?

OpenRouter fonctionne en prépayé. Vous achetez des crédits sur la page Credits, par carte ou avec l’un des autres moyens de paiement proposés, et chaque requête y est déduite. Au 18 novembre 2026, les conditions d’OpenRouter fixent un minimum de 5 $ par achat, ajoutent des frais de paiement et précisent que les crédits non utilisés peuvent expirer 365 jours après l’achat. Consultez openrouter.ai/terms pour les conditions à jour.

Chaque modèle a son propre prix par token, affiché sur sa page OpenRouter. Nous ne recopions pas ces prix ici, car ils changent. Oriveo affiche un coût estimé sur chaque réponse ; les pages d’activité et de facturation d’OpenRouter font foi.

Comment utiliser OpenRouter sur iPhone, Android ou le web ?

Comme il n’existe pas d’app mobile officielle OpenRouter, vous passez par une app cliente. Dans Oriveo, OpenRouter fait partie des 15 fournisseurs intégrés et figure parmi les Agrégateurs : vous n’avez aucune adresse à saisir.

  • Ouvrez Fournisseurs : un onglet sur iPhone et Android, ou la barre latérale sur le web.
  • Touchez le bouton + (Ajouter un fournisseur), puis choisissez OpenRouter. Le filtre Agrégateurs réduit la liste.
  • Collez votre clé sous « Connecter OpenRouter » et touchez Continuer.
  • Attendez la fin de « Validation de la connexion et synchronisation des modèles... » : Oriveo charge la liste des modèles d’OpenRouter.
  • Choisissez un modèle et commencez à discuter. Sans crédits, prenez un modèle dont l’identifiant se termine par « :free ».
Écran d’accueil d’Oriveo avec une zone de message, le modèle sélectionné juste en dessous et les chats du jour, chacun avec son coût
Une fois la clé connectée, choisissez un modèle sous la zone de message. Chaque chat de la liste affiche son coût estimé.

Où va ma clé OpenRouter ?

Sur iPhone et Android, les requêtes partent directement de votre appareil vers le fournisseur, et votre clé est conservée dans le stockage sécurisé du téléphone (le trousseau, ou Keychain, sur iPhone ; le Keystore sur Android). Dans l’app web, les requêtes passent par un relais en temps réel sur le serveur d’Oriveo : votre clé ne sert qu’à cette requête et n’est pas enregistrée dans les données de votre compte, et les conversations BYOK ne sont pas conservées sous forme de journaux. La synchronisation cloud n’envoie pas les clés. Pour utiliser OpenRouter sur un deuxième appareil, collez-y aussi la clé, ou créez-lui une clé distincte.

Vous payez OpenRouter directement, à ses prix. Oriveo n’ajoute aucune majoration.

Pourquoi ma clé API OpenRouter ne fonctionne-t-elle pas ?

La page des erreurs d’OpenRouter (openrouter.ai/docs/api-reference/errors) explique chaque code. Les plus courants, au 18 novembre 2026 :

  • Dans Oriveo, une erreur 402 s’affiche sous la forme « Quota du fournisseur atteint », et une erreur 429 sous la forme « Limite de débit » sur le web ou « Limite de débit du fournisseur atteinte » sur iPhone et Android.
  • Un modèle manque dans votre liste : resynchronisez la liste des modèles et vérifiez qu’OpenRouter le propose toujours.
Pourquoi ma clé API OpenRouter ne fonctionne-t-elle pas ?
ErreurSignificationQue faire
401 Invalid credentialsLa clé est incorrecte, désactivée ou suppriméeRecopiez la clé en entier, ou créez-en une nouvelle
401 « this is not an OpenRouter API key »Vous avez collé la clé d’un autre fournisseurUtilisez une clé créée sur openrouter.ai/keys ; elle commence par sk-or-v1-
402 insufficient creditsVotre compte ou cette clé n’a plus de créditsAjoutez des crédits ou relevez la limite de la clé ; attendre ne sert à rien
403 ForbiddenRequête bloquée par les permissions, la modération, un garde-fou (guardrail) ou une limite de budgetVérifiez les réglages et les limites de la clé, ou modifiez votre message
429 rate limitedTrop de requêtes, côté OpenRouter ou côté fournisseur du modèlePatientez puis réessayez ; avec les modèles gratuits, vérifiez les limites ci-dessus
502 ou 503Le modèle ou ses fournisseurs sont indisponibles pour le momentRéessayez plus tard ou choisissez un autre modèle

OpenRouter ou une clé par fournisseur ?

OpenRouter est pratique quand vous voulez beaucoup de modèles avec une seule clé et un seul solde. Une clé obtenue directement auprès d’un fournisseur comme OpenAI ou Anthropic vous convient si vous voulez le compte et la facturation propres à ce fournisseur. Oriveo accepte les deux : vous pouvez garder OpenRouter à côté de vos clés directes et passer d’un modèle à l’autre, successivement, dans la même conversation.

Questions fréquentes sur l’app

OpenRouter est-il gratuit ?
En partie. La clé est gratuite, et les modèles dont l’identifiant se termine par « :free » ne coûtent rien dans la limite d’un quota quotidien : au 18 novembre 2026, 50 requêtes par jour, ou 1 000 une fois que vous avez acheté au moins 10 crédits. Les autres modèles nécessitent des crédits prépayés.
Où obtenir ma clé API OpenRouter ?
Sur openrouter.ai/keys, après connexion. Créez une clé, donnez-lui un nom et copiez-la en entier ; elle commence par « sk-or-v1- ».
Existe-t-il une app OpenRouter pour iPhone ou Android ?
OpenRouter ne publie pas sa propre app de chat mobile. Utilisez une app de chat qui accepte une clé OpenRouter : dans Oriveo, ouvrez Fournisseurs, touchez +, choisissez OpenRouter, collez la clé et touchez Continuer.
Que signifie l’erreur OpenRouter 402 ?
Votre compte, ou la clé que vous utilisez, n’a plus assez de crédits. Ajoutez des crédits sur OpenRouter, ou relevez la limite de la clé si vous en avez fixé une, puis réessayez. L’erreur ne disparaîtra pas d’elle-même.
Pourquoi ma clé API OpenRouter ne fonctionne-t-elle pas ?
Regardez le numéro d’erreur. 401 : la clé est incorrecte ou n’est pas une clé OpenRouter ; 402 : plus de crédits ; 429 : trop de requêtes ou limite des modèles gratuits atteinte. Notre guide des erreurs de clé API détaille chaque code.
À quoi ressemble une clé API OpenRouter ?
Elle commence par « sk-or-v1- », puis comporte 64 lettres et chiffres, soit 73 caractères au total. Si la vôtre est plus courte, une partie n’a pas été copiée.

À lire aussi

Sur le blog

Utilisez votre clé OpenRouter sur votre téléphone

Ouvrez l’app web ou téléchargez Oriveo pour iPhone ou Android, collez votre clé OpenRouter et passez d’un modèle à l’autre avec un coût estimé sur chaque réponse.

Vous n’avez pas encore de clé API ? Commencez avec Oriveo Free.