# Clés API plafonnées : limite de dépense et expiration

> Chaque clé API Tchavi peut avoir une date d'expiration et une limite de dépense en crédits : fonctionnement, erreur 403 et points à surveiller.

- Published: 2026-10-20
- Author: Gael — fondateur de Tchavi
- Canonical: https://tchavi.com/fr/blog/cles-api-plafonnees-limite-depense-expiration

---


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 :

```json
{
  "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](https://tchavi.com/fr/blog/claude-code-sans-carte-bancaire-mobile-money).

## Comment l'essayer

1. Ouvre la page [Clés API](https://tchavi.com/fr/dashboard/api-keys) de ton tableau de bord.
2. Crée une clé : choisis l'expiration et saisis la limite.
3. Lis la section [Expiration et limite de dépense](https://tchavi.com/fr/docs/authentication) 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](https://tchavi.com/fr/register?next=%2Fdashboard%2Fbilling%3Famount%3D1000%26currency%3DXOF%26from%3Dblog-spend-keys)

> _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](https://tchavi.com/fr/docs/payments)). Plus de guides sur [le blog](https://tchavi.com/fr/blog). Pour suivre les prochains : [LinkedIn](https://www.linkedin.com/company/tchavi) et [X](https://x.com/tchaviai)._