Comment vérifier mes crédits et mes dépenses OpenRouter ?

Dernière mise à jour : 26 septembre 2026

Ton solde est sur la page Credits à openrouter.ai/settings/credits. La page Activity à openrouter.ai/activity montre ce que tu as dépensé, par modèle, fournisseur et clé d’API. Depuis le code, GET /api/v1/key montre ce qu’une clé a dépensé et ce qu’il reste de son plafond.

Ci-dessous : les deux appels d’API et la clé qu’exige chacun, les plafonds par clé, ce qui se passe à zéro et quels frais s’appliquent. Cela suit la documentation d’OpenRouter à la date ci-dessus.

Sur le site web

Page Credits (openrouter.ai/settings/credits). Ton solde, et l’endroit où tu recharges. OpenRouter compte les crédits en dollars américains. Tu peux recharger à la main, ou activer la recharge automatique, qui remplit le solde dès qu’il passe sous un seuil que tu fixes.
Page Activity (openrouter.ai/activity). Tes dépenses, requêtes et tokens sur n’importe quelle période. Tu peux filtrer par modèle, fournisseur et clé d’API, et exporter les résultats en CSV ou en PDF.

OpenRouter facture le prix indiqué par token et le déduit de tes crédits après chaque requête.

Par l’API

Deux appels comptent ici, et ils demandent des clés différentes.

GET https://openrouter.ai/api/v1/key — envoie-le avec la clé d’API normale, comme jeton Bearer. Il renseigne sur cette seule clé : usage (depuis le début), usage_daily, usage_weekly et usage_monthly, tous en crédits. Jour, semaine et mois suivent l’UTC ; la semaine commence le lundi. Il renvoie aussi le plafond de la clé (limit, limit_remaining, limit_reset), l’utilisation BYOK dans des champs séparés, et is_free_tier, qui dit si tu as déjà payé des crédits.
GET https://openrouter.ai/api/v1/credits — renvoie total_credits (acheté) et total_usage (utilisé) pour tout le compte. Ton solde est le premier moins le second. La référence d’OpenRouter dit que cet appel exige une clé de gestion. Tu en crées une sur la page Management API Keys. Elle ne sert qu’aux tâches d’administration, comme la gestion des clés, et ne peut pas appeler de modèles.

GET /api/v1/key fonctionne avec la clé d’API normale que tu utilises pour tes requêtes et ne renseigne que sur cette clé. GET /api/v1/credits renvoie les crédits achetés et utilisés sur tout le compte, mais OpenRouter dit qu’il faut une clé de gestion, qui ne peut pas appeler de modèles.

/api/v1/key n’affiche donc pas le solde de ton compte. Si tu utilises plusieurs clés, chacune ne montre que ses propres dépenses.

Plafonds par clé

Tu peux donner à chaque clé d’API son propre plafond de dépenses. C’est facultatif ; sans plafond, limit et limit_remaining reviennent vides, ce qui veut dire « pas de plafond », pas « plus rien ». Un plafond peut se réinitialiser chaque jour, semaine ou mois — limit_reset nomme le rythme, pas une date. Une réinitialisation quotidienne a lieu à minuit UTC.

Un plafond n’ajoute pas d’argent. Il empêche seulement une clé de dépenser plus que ce que tu autorises, même quand le compte a largement de quoi. Un réglage de la clé décide si l’utilisation BYOK compte dans le plafond.

Ce qui se passe à zéro

Les requêtes échouent avec l’erreur 402, Payment Required. Avec un solde négatif, cela peut toucher aussi les modèles gratuits. Ajoute des crédits pour remettre le solde au-dessus de zéro, et ils refonctionnent.

Le corps de l’erreur indique quelle limite tu as atteinte, dans metadata.limit_source :

openrouter_credits — le solde ne couvre pas la requête.
openrouter_key_limit — le plafond de la clé est épuisé. Relève-le ou attends la réinitialisation.
openrouter_in_flight_budget — trop de requêtes payantes en cours en même temps pour ton solde. OpenRouter retient une estimation du coût de chaque requête pendant qu’elle tourne. Pour les comptes à petit solde, et pour certains plus récents, le total retenu peut atteindre une limite avant le solde. Attends le délai de l’en-tête Retry-After et réessaie.

Les modèles gratuits (IDs finissant par :free) ont leurs propres limites de requêtes : 20 par minute, et 50 par jour si tu as acheté moins de 10 crédits au total, 1 000 par jour si tu en as acheté au moins 10. /api/v1/key montre le compte quotidien dans free_model_daily_requests.

Frais

OpenRouter dit n’ajouter aucune majoration aux prix des modèles. Elle prélève des frais à l’achat de crédits : 5,5 %, au moins 0,80 $, par carte, et 5 % pour les cryptomonnaies.

Avec BYOK (« bring your own key »), tu enregistres dans OpenRouter une clé d’un autre fournisseur, et ce fournisseur te facture les tokens. OpenRouter facture-t-il quelque chose pour cela ?

Oui, au-delà d’une franchise gratuite. Le paiement à l’usage comprend 25 000 $ d’utilisation au prix catalogue par mois, Enterprise 200 000 $. Au-delà, les frais sont de 5 % de ce que le même modèle et le même fournisseur coûteraient sur OpenRouter, prélevés sur tes crédits.

Deux règles de plus tirées de la FAQ d’OpenRouter. Elle peut faire expirer les crédits inutilisés un an après l’achat. Et tu ne peux demander le remboursement de crédits inutilisés que dans les 24 heures suivant leur achat, avec le bouton de remboursement de la page Credits ; les frais ne sont pas remboursés.

Ce qu’AI Cockpit lit chez OpenRouter et sur les autres comptes d’API : voir Les coûts d’API d’IA en un coup d’œil.

Dans AI Cockpit

La carte OpenRouter se trouve dans la barre des menus du Mac, dans l’app sur iPhone et iPad, et dans la zone de notification de Windows. Sur Apple Watch (via l’app iPhone), elle apparaît comme une ligne dans la liste des sources. Une clé d’API normale suffit ; pas de clé de gestion.

Ce que la clé a dépensé aujourd’hui, cette semaine, ce mois-ci et au total, en dollars américains, lu depuis /api/v1/key. Sur le Mac, elle s’actualise toutes les cinq minutes par défaut.
Si tu as une utilisation BYOK ce mois-ci, une ligne pour elle, séparée de la dépense en crédits.
Si la clé a un plafond, une barre avec la part utilisée et le rythme de réinitialisation, comme « mensuel ». Elle passe en couleur d’alerte par défaut à 75 et 90 % sur le Mac, à 80 et 95 % sur iPhone et Apple Watch. Sans plafond, la carte l’indique et n’affiche pas de barre.
Un badge « Free tier » si tu n’as jamais acheté de crédits.

Ce qu’elle n’affiche pas : le solde de ton compte (l’app n’appelle pas /api/v1/credits), la dépense par modèle, ni le nombre de requêtes des modèles gratuits. Elle ne peut pas non plus recharger.

Des réponses courtes à d’autres questions se trouvent sur la page FAQ.