Solde et quotas

RouteAPI fonctionne en prépayé : vous rechargez d’abord votre compte, puis chaque appel est débité du solde selon l’usage réel. Vous pouvez définir un quota propre à chaque clé API et activer la recharge automatique pour éviter toute interruption de service en cas d’épuisement du solde.

Facturation en dollars américains

Le solde du compte, le prix des modèles, le quota des clés API et le montant des recharges sont tous exprimés en dollars américains (USD). La console peut convertir les montants dans une autre devise selon les réglages du site, mais il ne s’agit que d’une conversion d’affichage : les débits et la comptabilité restent toujours en USD.

Solde du compte

Le solde du compte est le fonds commun à toutes vos clés API. Consultez votre solde actuel et votre consommation passée sur la page Portefeuille.

Chaque requête est débitée du solde du compte ; le solde ne peut jamais devenir négatif.
Si le solde ne couvre pas le coût estimé d’une requête, celle-ci est rejetée avec un code 403 et le code d’erreur insufficient_user_quota. Voir Utilisation et facturation pour la méthode d’estimation.
Si votre compte bénéficie d’une remise exclusive, la place des modèles affiche le prix remisé et le journal d’utilisation signale le « tarif exclusif » ; le débit est calculé au prix remisé.

Quota des clés API

Lorsque vous créez ou modifiez une clé sur la page Clés API, vous pouvez définir pour chaque clé :

Réglage	Description
Quota (USD)	Montant maximal que cette clé peut consommer ; peut aussi être illimité
Date d’expiration	La clé devient invalide à l’expiration ; par défaut, elle n’expire jamais
Modèles autorisés	Seuls les modèles spécifiés peuvent être appelés avec cette clé
Liste blanche d’IP	Seules les requêtes provenant des IP spécifiées sont acceptées

Le quota d’une clé est une limite haute, pas un portefeuille séparé. Une requête débite à la fois le quota de la clé et le solde du compte ; si l’un des deux est insuffisant, la requête est rejetée. Même avec un quota illimité, le montant réellement disponible reste limité par le solde du compte.

L’usage courant consiste à créer une clé par projet, environnement ou membre, chacune avec son propre quota, pour éviter qu’une seule application épuise le solde de tout le compte. La liste des clés API affiche le quota utilisé et le quota total de chaque clé.

Cas	Réponse
Quota de la clé épuisé	`401`, message indiquant que le quota de la clé est épuisé
Quota restant de la clé insuffisant pour le coût estimé	`403`, code d’erreur `pre_consume_token_quota_failed`
Clé expirée ou désactivée	`401`
Modèle non autorisé pour la clé, ou IP source hors liste blanche	`403`

Recharge

Sur la page Portefeuille, choisissez un montant et un moyen de paiement pour recharger ; le minimum est de 1 dollar. Les moyens de paiement disponibles sont ceux affichés sur la page Portefeuille.

Le solde est crédité selon le montant en dollars saisi.
Pour un paiement par carte bancaire via Stripe, le débit réel inclut des frais de 4 % du montant rechargé, destinés à couvrir les frais de traitement du paiement et les taxes. Le montant réellement débité est affiché avant le paiement.

Recharge automatique

Une fois la recharge automatique activée, lorsque le solde descend sous le seuil défini, le système recharge automatiquement un montant fixe avec la carte bancaire enregistrée. Ce mode convient aux environnements de production devant tourner de manière stable sur la durée. Configurez-la dans « Recharge automatique » sur la page Portefeuille.

Réglage	Description	Plage
Seuil de déclenchement	Recharge déclenchée lorsque le solde descend sous ce montant	Au plus 1 000 USD, 20 USD par défaut
Montant par recharge	Montant de chaque recharge automatique	10–5 000 USD, 100 USD par défaut
Plafond mensuel	Plafond cumulé des recharges automatiques sur un mois civil ; 0 signifie illimité	Au plus 50 000 USD, et pas moins que le montant par recharge
Moyen de paiement	Carte bancaire débitée	Jusqu’à 3 cartes enregistrées, utilisées dans l’ordre défini

Fonctionnement :

Le solde est vérifié après chaque règlement de requête ; une recharge est déclenchée si le solde est sous le seuil. Deux recharges automatiques sont espacées d’au moins 10 minutes.
Si le solde est déjà sous le seuil au moment de l’enregistrement des réglages, une recharge est déclenchée immédiatement.
Si la carte par défaut est explicitement refusée (carte expirée, refus de la banque émettrice, etc.), la carte enregistrée suivante est essayée. En cas de résultat ambigu (vérification 3D par exemple), aucune autre carte n’est essayée, afin d’éviter un double débit.
Si toutes les cartes échouent, les tentatives sont relancées automatiquement après 15 minutes, 1 heure, 3 heures et 6 heures. En cas d’échec persistant, les tentatives s’arrêtent et un e-mail de notification vous est envoyé. La page Portefeuille affiche également une alerte : après avoir changé de moyen de paiement, vous pouvez cliquer sur « Recharger maintenant ».
Une fois le plafond mensuel atteint, plus aucune recharge automatique n’est effectuée ce mois-ci.
La recharge automatique est également soumise aux frais de 4 %.

Alertes de solde

Dans les paramètres de notification de vos Paramètres personnels, vous pouvez définir un seuil d’alerte : lorsque le solde passe sous ce seuil, vous êtes notifié par e-mail, Webhook, Bark ou Gotify. Si le solde est épuisé et qu’une requête est rejetée, un e-mail de rappel est également envoyé, au plus une fois par jour.

Que faire en cas de solde insuffisant

Rechargez depuis la page Portefeuille, ou activez la recharge automatique.
Si le code d’erreur est pre_consume_token_quota_failed, ou si le message indique que le quota de la clé est épuisé, il faut augmenter le quota de cette clé ; recharger le compte n’y changera rien.
Si le solde semble suffisant mais que la requête est toujours rejetée, vérifiez que max_tokens dans la requête n’est pas trop élevé. Le coût estimé tient compte de max_tokens ; voir Utilisation et facturation.
Vérifiez votre consommation récente dans le Journal d’utilisation.