Chaque clé API Tchavi peut maintenant avoir une date d'expiration et une limite de dépense en crédits. Tu confies une clé à un stagiaire, à une démo ou à un job CI, et elle s'arrête toute seule, à la date prévue ou au plafond atteint.
En bref
- Tchavi, une passerelle d'API IA compatible OpenAI que tu paies en mobile money, ajoute deux réglages par clé : une expiration et une limite de dépense.
- Expiration : jamais, 1 heure, 1 jour, 3 jours, 7 jours, 1 mois, ou une date personnalisée.
- Limite : le maximum en crédits que la clé peut dépenser sur toute sa durée de vie.
- Au plafond, la requête reçoit une erreur 403
key_spend_limit_reached.
L'expiration
Dans le formulaire de création de clé, le champ Expiration propose : Jamais, 1 heure, 1 jour, 3 jours, 7 jours, 1 mois et Date personnalisée. Une date dans le passé est refusée. Avec Jamais, la clé fonctionne jusqu'à ce que tu la révoques.
Passé la date, la clé renvoie 403 key_inactive avec details.status: "EXPIRED". Dans la liste de tes clés, elle apparaît comme Expirée, avant même sa prochaine utilisation, et ne compte plus dans le nombre maximal de clés de ton niveau.
La limite de dépense
Le champ Limite de dépense est un nombre de crédits. Laisse-le vide pour ne pas limiter. Il accepte jusqu'à 3 décimales. À 3 crédits pour 1 F, une limite de 3 000 crédits correspond à 1 000 F.
Le principe : chaque requête réserve d'abord son coût estimé. Si cette réserve ne tient pas dans ce qui reste à la clé, la requête est refusée avec une erreur 403 :
{
"error": "key_spend_limit_reached",
"message": "…",
"statusCode": 403
}
C'est un 403 et non un 402, parce qu'une recharge ne changerait rien : c'est la clé qui est plafonnée, pas ton solde. L'erreur indique aussi la limite, ce que la clé a déjà dépensé, ce qui reste et ce que la requête demandait.
Modifier la limite
La liste des clés affiche la dépense de chaque clé face à sa limite (par exemple « 120 sur 3 000 ») et son expiration. Quand une clé atteint sa limite, elle est marquée Limite atteinte. Tu peux relever la limite, la baisser ou la retirer depuis le tableau de bord ; ce que la clé a déjà dépensé est conservé.
Ce qu'il faut surveiller
Le streaming peut dépasser un peu. Une requête en streaming réserve son coût estimé au départ. Si le coût final est plus élevé, la différence est quand même facturée : une clé peut finir légèrement au-dessus de sa limite. À l'inverse, comme chaque requête réserve son estimation jusqu'à sa fin, une clé peut s'arrêter un peu avant son plafond. Prévois donc une petite marge.
Le plafond est cumulé. Il porte sur toute la durée de vie de la clé, pas sur un jour ou un mois.
Trois usages concrets
- Un stagiaire ou un prestataire : une clé à 1 500 crédits (500 F), qui expire dans 7 jours.
- Une démo client : une clé de 1 heure, plafonnée à quelques centaines de crédits.
- Un job CI : une clé à durée longue mais plafonnée, pour que le job ne puisse pas vider ton solde.
Je donne ces chiffres comme points de départ à ajuster. Pour voir un cas réel, lis comment utiliser Claude Code avec une clé plafonnée.
Comment l'essayer
- Ouvre la page Clés API de ton tableau de bord.
- Crée une clé : choisis l'expiration et saisis la limite.
- Lis la section Expiration et limite de dépense de la documentation.
FAQ
Une requête refusée est-elle facturée ?
Non : la requête n'est pas servie, donc rien n'est débité.
Que faire quand une clé atteint sa limite ?
Relève la limite depuis la liste des clés, ou crée une nouvelle clé. La clé refonctionne tout de suite après la modification.
Puis-je plafonner une clé qui existe déjà ?
Oui : la liste des clés propose Limite de dépense pour une clé active.
crée ton compte et recharge 1 000 F
Cet article fait partie de la série « Construire un SaaS IA depuis l'Afrique francophone ». Tchavi est une passerelle d'API IA compatible OpenAI : une seule clé donne accès à plus de 100 modèles de texte, d'image, d'audio et de vidéo, et tu la paies en mobile money, sans carte bancaire (pays et opérateurs). Plus de guides sur le blog. Pour suivre les prochains : LinkedIn et X.