Recharge automatique des crédits d'API d'IA : comment la recharge automatique de TokenLab évite les interruptions de solde

Un agent en production peut épuiser un solde de crédits en quelques minutes, et un solde vide transforme chaque requête en arrêt brutal. La recharge automatique de TokenLab est le paramètre au niveau de l'organisation que nous avons conçu pour éviter ce mode de défaillance : elle achète du crédit supplémentaire lorsque votre solde descend en dessous d'un seuil que vous avez défini. Lorsqu'elle est bien configurée, une boucle d'agent, un traitement par lots ou un pic de trafic continue de fonctionner au lieu de se heurter au mur d'un solde vide. Voici comment fonctionne la logique de déclenchement, ce qui se passe lorsqu'une carte est refusée pendant une recharge, les montants réels minimum et maximum, et comment l'activer depuis le tableau de bord de facturation.

Points clés à retenir

• La recharge automatique est une option à activer et se configure par organisation depuis le tableau de bord de facturation par un administrateur ou un propriétaire. Elle n'est pas activée par défaut.
• Les paramètres par défaut sont un montant de déclenchement de 5 $, un montant de restauration de 30 $ et une limite de recharge mensuelle de 300 $. Le montant minimum lié à la recharge est de 1 $ et la limite mensuelle maximale est de 10 000 $.
• En cas d'échec de paiement, nous ne procédons pas à une nouvelle tentative silencieuse. Nous désactivons la recharge automatique, marquons la transaction comme payment_failed ou requires_action, et envoyons un e-mail d'échec.
• Il n'existe actuellement aucune API publique ni aucun webhook pour configurer ou surveiller la recharge automatique. La configuration s'effectue dans le tableau de bord ; la surveillance se fait via le statut du tableau de bord, les e-mails et l'historique des transactions.
• Un moyen de paiement Stripe enregistré est requis avant de pouvoir activer la recharge automatique.

Comment activer la recharge automatique TokenLab et définir vos seuils

1. Connectez-vous en tant qu'administrateur ou propriétaire de l'organisation et ouvrez le tableau de bord de facturation.
2. Ajoutez un moyen de paiement si ce n'est pas déjà fait. La recharge automatique ne peut pas être activée sans un moyen de paiement Stripe enregistré.
3. Définissez When balance drops below (le montant de déclenchement). Il s'agit du niveau de solde qui déclenche un rechargement.
4. Définissez Restore balance to (le montant de restauration). Il doit être supérieur au montant de déclenchement ; c'est le solde que vous atteignez après une recharge.
5. Définissez une limite de recharge mensuelle, ou laissez-la activée avec suffisamment de marge pour couvrir au moins un cycle de recharge.
6. Enregistrez et confirmez que la recharge automatique est active. Le tableau de bord affichera son statut actuel (active, en pause ou désactivée).

Si vous ne personnalisez pas ces champs, TokenLab applique les valeurs par défaut : déclenchement à 5 $, restauration à 30 $, limite mensuelle à 300 $. Ces valeurs par défaut conviennent à un espace de travail à faible volume testant l'API. Elles sont presque certainement trop basses pour un agent en production ou un chatbot destiné aux clients. Dimensionnez-les en fonction de votre mix de modèles réel, abordé ci-après.

Les montants de déclenchement et de restauration appropriés dépendent des modèles que vous appelez, car les coûts par token varient fortement dans le catalogue de TokenLab. Si vous définissez un montant de restauration trop bas par rapport à votre taux de consommation, vous risquez d'atteindre à nouveau le seuil de déclenchement avant que la recharge précédente n'ait eu le temps d'être prise en compte.

Modèle	Fournisseur	Entrée ($/MTok)	Sortie ($/MTok)	Fenêtre de contexte	Source	Observé le
Claude Sonnet 5	Anthropic	2,00 $	10,00 $	1 000 000	Instantané des prix en direct TokenLab	2026-07-09
GPT-5.5	OpenAI	5,00 $	30,00 $	1 050 000	Instantané des prix en direct TokenLab	2026-07-09
Gemini 3.5 Flash	Google	1,50 $	9,00 $	1 048 576	Instantané des prix en direct TokenLab	2026-07-09
DeepSeek V4 Flash	DeepSeek	0,09 $	0,18 $	1 048 576	Instantané des prix en direct TokenLab	2026-07-09
GLM-5.2	Z.ai	0,70 $	2,20 $	1 048 576	Instantané des prix en direct TokenLab	2026-07-09

Un pipeline fonctionnant principalement sur DeepSeek V4 Flash pour la rédaction avec GPT-5.5 pour la sortie finale consomme du crédit à un rythme très différent de celui fonctionnant entièrement sur GPT-5.5. Par exemple, une semaine intensive en GPT-5.5 déclenchera des recharges beaucoup plus souvent qu'une semaine intensive en DeepSeek V4 Flash. Chaque recharge est décomptée de votre limite mensuelle. Nous vous recommandons de vérifier votre mix d'utilisation réel avant de verrouiller un seuil. Pour une comparaison complète des tarifs dans tout le catalogue, consultez la page de comparaison des prix.

Comment fonctionne réellement la logique de déclenchement

La recharge automatique ne vérifie pas votre solde sur une minuterie fixe. Nous vérifions le solde après chaque règlement et le comparons à votre montant de déclenchement configuré. Si le solde après règlement est inférieur au seuil, une tentative de recharge démarre.

Un déclenchement est ignoré (non exécuté) lorsque l'une des conditions suivantes est vraie :

• Le solde actuel est déjà supérieur au montant de déclenchement.
• Une autre recharge automatique pour l'organisation est déjà en attente.
• Un verrouillage de déclenchement est actif (empêche les recharges en double lors de règlements consécutifs rapides).
• Aucun moyen de paiement n'est enregistré sur le compte.
• L'exécution de cette recharge dépasserait la limite de recharge mensuelle.

Si la limite mensuelle est dépassée, nous mettons la recharge automatique en pause et enregistrons lastFailureCode: "monthly_limit_reached". Il s'agit d'un arrêt délibéré, pas d'un bug. Cela vous protège contre des dépenses mensuelles incontrôlées si votre limite mensuelle est définie trop bas par rapport à votre utilisation réelle. Si vous voyez ce statut, augmentez votre limite mensuelle jusqu'au plafond de 10 000 $ ou réactivez-la manuellement après avoir examiné pourquoi la limite a été atteinte.

Lorsqu'une recharge est déclenchée, nous créons une facture Stripe en USD et la débitons automatiquement de votre moyen de paiement enregistré.

Que se passe-t-il lorsque votre carte est refusée pendant la recharge automatique TokenLab ?

C'est la question qui détermine si vous pouvez faire confiance à la recharge automatique pour la disponibilité en production. L'implémentation de la facturation y répond directement.

En cas de paiement réussi, nous créditons le solde de votre organisation une fois et marquons la transaction comme terminée. Nous enregistrons l'URL de la facture ou du reçu lorsqu'elle est disponible, augmentons votre total de dépenses mensuelles, maintenons la recharge automatique active pour la prochaine fois et envoyons un e-mail de succès de paiement.

En cas d'échec de paiement ou d'action requise de la part du client (par exemple, vérification 3D Secure), nous marquons la transaction comme échouée. Nous désactivons la recharge automatique, définissons le statut sur payment_failed ou requires_action, enregistrons les détails de l'échec et envoyons un e-mail d'échec de paiement.

Ce dernier point est plus important qu'un nombre de tentatives de nouvelle exécution. Nous ne tentons pas de relancer silencieusement une carte refusée. Nous ne laissons pas la recharge automatique active en arrière-plan tout en échouant. Elle échoue de manière fermée : la fonctionnalité se désactive d'elle-même, et vous recevez un e-mail vous expliquant pourquoi. Vos requêtes cesseront toujours de fonctionner une fois que le solde atteindra zéro, mais vous ne resterez pas à vous demander si la recharge automatique vous couvre alors que ce n'est pas le cas.

Ce que cela signifie pour votre configuration opérationnelle :

• Traitez l'e-mail d'échec de paiement comme une alerte actionnable, pas comme une notification à ignorer. Cela signifie que la recharge automatique est désormais désactivée jusqu'à ce que vous corrigiez le moyen de paiement et la réactiviez depuis le tableau de bord.
• Gardez votre moyen de paiement enregistré à jour. Une carte expirée est la cause la plus probable d'un état payment_failed, et il n'y a pas de secours automatique vers une carte secondaire dans cette implémentation.
• Si la disponibilité est critique, ne vous fiez pas uniquement à l'e-mail. Mettez en place une vérification de solde indépendante ci-dessous afin qu'un e-mail manqué ou filtré ne se transforme pas en panne non détectée.

Existe-t-il une API ou un webhook pour la recharge automatique TokenLab ?

Pas actuellement. La configuration de la recharge automatique (montant de déclenchement, montant de restauration, limite mensuelle, moyen de paiement) est réservée au tableau de bord pour les administrateurs et propriétaires de l'organisation. Il n'existe aucun point de terminaison d'API publique documenté pour définir ces seuils par programmation, et aucun webhook public documenté qui se déclenche lors d'événements de déclenchement, de succès ou d'échec.

Les surfaces de surveillance destinées aux clients qui existent sont :

• Statut du tableau de bord. Affiche si la recharge automatique est active, en pause ou désactivée, et le dernier code d'échec le cas échéant.
• Notifications par e-mail. Avertissements de solde faible et e-mails de succès ou d'échec de paiement.
• Historique des transactions. Un enregistrement de chaque tentative de recharge, son résultat et les liens vers la facture ou le reçu associés lorsqu'ils sont disponibles.

Si vous avez besoin d'une surveillance programmatique pour un système de production, la solution de contournement pratique aujourd'hui est une tâche planifiée qui vérifie le solde de votre organisation via l'accès en lecture authentifié fourni par votre session de tableau de bord. Alertez votre équipe si le solde descend en dessous d'un second seuil, plus bas que votre déclencheur de recharge automatique. Cela vous donne un signal indépendant même si la recharge automatique elle-même est désactivée après un échec de carte. Ne construisez pas de code d'intégration basé sur un point de terminaison ou une structure de charge utile supposés. Si TokenLab documente une API de facturation ou un webhook, vérifiez le contrat exact dans la référence de l'API avant de l'intégrer dans un pipeline d'alerte.

Montants minimum, maximum et par défaut

Champ	Minimum	Maximum	Par défaut	Notes
Montant de déclenchement (balance drops below)	1 $	Inférieur au montant de restauration	5 $	Doit rester inférieur au montant de restauration
Montant de restauration (restore balance to)	1 $	Limité par la limite mensuelle	30 $	Doit être supérieur au montant de déclenchement
Limite de recharge mensuelle	Doit couvrir un cycle de recharge	10 000 $	300 $	Les recharges se mettent en pause avec monthly_limit_reached une fois ce seuil atteint

Source : Tableau de bord de facturation TokenLab et implémentation de la recharge automatique, /dashboard/billing, observé le 2026-07-09.

Si vous exécutez une charge de travail de production avec un risque réel de pic, la limite mensuelle par défaut de 300 $ est souvent trop conservatrice. Une seule après-midi de génération d'images ou de vidéos, ou une journée chargée d'appels d'outils d'agent, peut atteindre ce plafond rapidement. Augmentez-la délibérément après avoir estimé votre mix de modèles et vos dépenses quotidiennes typiques, et non après avoir été mis en pause en pleine charge de travail.

Qui doit activer cela, et que vérifier avant de s'y fier

La recharge automatique n'est pas nécessaire pour chaque espace de travail. Si l'utilisation est faible et prévisible, les recharges manuelles fonctionnent très bien. Configurez-la si l'un des cas suivants s'applique :

• Agents autonomes ou semi-autonomes. Les boucles d'agents fonctionnant sur des modèles comme Claude Sonnet 5 ou Kimi K2.7 Code peuvent consommer des crédits de manière inégale. Par exemple, une boucle bloquée épuise le solde plus rapidement qu'un humain ne risque de le remarquer.
• Chatbots destinés aux clients. Les chatbots de support et de produit voient un trafic qui évolue avec l'utilisation de votre propre produit. Un pic le week-end ne devrait pas devenir une panne le lundi.
• Charges de travail de génération par pics. Les tâches d'image et de vidéo (Nano Banana Pro, Seedance, Veo 3) se regroupent autour des lancements ou des lots de contenu. Une seule session de rendu peut coûter plus cher qu'une semaine typique.
• Tâches par lots planifiées. Les pipelines nocturnes ou hebdomadaires sont exactement là où une défaillance de solde en cours d'exécution est coûteuse à diagnostiquer et à relancer.

Étape	Ce qu'il faut vérifier	Pourquoi c'est important
Confirmer que le moyen de paiement est à jour	Carte non expirée, vérifiée dans le tableau de bord	La recharge ne peut pas se déclencher sans un moyen de paiement enregistré valide
Définir le montant de déclenchement au-dessus de votre consommation quotidienne maximale	Basez-le sur votre journée la plus chargée, pas sur votre moyenne	Trop bas, et un pic peut épuiser le solde avant que la recharge n'arrive
Définir le montant de restauration au-dessus des dépenses hebdomadaires	Utilisez le tableau de prix des modèles ci-dessus pour estimer	Une semaine intensive en GPT-5.5 coûte beaucoup plus cher qu'une semaine en DeepSeek V4 Flash
Définir la limite mensuelle avec une vraie marge	Le défaut de 300 $ est souvent trop bas pour la production	Atteindre la limite met la recharge automatique en pause avec monthly_limit_reached
Traiter les e-mails d'échec comme des alertes	Acheminez les e-mails d'échec de paiement vers un canal d'astreinte	La recharge automatique se désactive elle-même en cas d'échec ; rien d'autre ne vous le dira
Ajouter une surveillance de solde indépendante	Interrogez le solde selon un calendrier en dehors du déclencheur de la recharge automatique	Aucun webhook public n'existe encore ; ne vous fiez pas uniquement à la visibilité du tableau de bord
Examiner l'utilisation chaque semaine	Vérifiez la consommation par modèle et par projet	La recharge automatique supprime le risque de panne, pas la visibilité des coûts

Pour des comparaisons de coûts de modèles afin d'informer vos seuils, consultez la page de comparaison des prix. Pour transférer des appels non critiques vers des modèles moins chers comme DeepSeek V4 Flash ou Gemini 3.5 Flash, consultez la page des classements des modèles.

La recharge automatique est un filet de sécurité, pas un chèque en blanc. Elle résout un mode de défaillance spécifique : manquer de crédit en pleine charge de travail. Elle ne gère pas votre budget, et la limite mensuelle existe précisément pour cela. Les équipes qui en tirent le meilleur parti associent un montant de restauration réaliste à une limite mensuelle qui reflète l'utilisation réelle. Elles acheminent également les e-mails d'échec là où un humain les verra réellement, et non dans une boîte de réception partagée qui est ignorée.

Limitations et considérations :

• Structure des frais. Le fait que les factures de recharge automatique comportent des frais de traitement au-delà du montant du crédit n'est pas confirmé dans la documentation de facturation publiée par TokenLab. Vérifiez directement les lignes de votre facture Stripe ou les conditions de facturation.
• Latence de traitement. Le temps entre une recharge déclenchée et la prise en compte du nouveau solde sur votre compte n'a pas été évalué ici. Si une charge de travail a une date limite stricte, testez avec une recharge manuelle d'abord et observez le timing du tableau de bord avant de vous fier à la recharge automatique pour un pic sensible au temps.
• Accès programmatique. Aucune API publique ou aucun webhook pour la configuration ou les événements de recharge automatique n'est documenté aujourd'hui. Si TokenLab en ajoute un, vérifiez le point de terminaison et la charge utile exacts dans la référence officielle de l'API avant de construire dessus.

FAQ

Puis-je configurer la recharge automatique TokenLab avec une API ?

Pas actuellement. La recharge automatique est configurée via le tableau de bord de facturation par un administrateur ou un propriétaire de l'organisation. Il n'existe aucun point de terminaison d'API publique documenté pour définir les valeurs de déclenchement, de restauration ou de limite mensuelle par programmation.

Quels sont les montants de déclenchement et de restauration par défaut ?

Les valeurs par défaut sont : déclenchement à 5 $, restauration à 30 $, limite mensuelle à 300 $. Le minimum pour le déclenchement, la restauration et les montants associés est de 1 $. La limite de recharge mensuelle maximale est de 10 000 $.

Que se passe-t-il si ma carte est refusée pendant une recharge ?

Nous marquons la transaction comme échouée, désactivons la recharge automatique, définissons le statut sur payment_failed ou requires_action, enregistrons les détails de l'échec et envoyons un e-mail d'échec de paiement. Nous ne procédons pas à une nouvelle tentative silencieuse.

La recharge automatique TokenLab réessaie-t-elle après un échec de paiement ?

Aucune nouvelle tentative automatique n'est intégrée dans l'implémentation actuelle. Au lieu de cela, la fonctionnalité se désactive d'elle-même et vous en informe par e-mail afin que vous puissiez corriger le moyen de paiement et la réactiver manuellement.

La recharge automatique TokenLab est-elle activée par défaut ?

Non. Elle est à activer par organisation et nécessite un moyen de paiement enregistré avant de pouvoir être activée.

Configurez la recharge automatique depuis le tableau de bord de facturation, ou comparez d'abord les prix des modèles sur la page des modèles pour dimensionner correctement vos seuils.