# Crédits et facturation

> Les mêmes droits et le même solde en dinars pour l'application et l'API, la réservation à chaque appel, le plafond mensuel par clé et ce qui n'existe pas encore.

Source : https://developers.tuk-ai.com/docs/billing · Vérifié le 2026-10-04

## Un seul compte, les mêmes droits

L'API passe par **les mêmes contrôles** que l'application Tukai : même abonnement, mêmes crédits en dinars tunisiens, mêmes limites d'usage. Il n'y a pas de portefeuille séparé pour les développeurs. Ce qui est consommé dans le chat, le Studio ou par l'API sort du même compte.

Conséquence directe : les limites d'usage de votre offre (fenêtres de session, de semaine ou de période d'abonnement, débit, requêtes simultanées) s'appliquent **aussi** à vos appels API. Un usage intensif du chat peut donc faire refuser vos appels API (`429`), et inversement.

Pour appeler l'API, le compte doit avoir un abonnement actif ou des crédits. Sans l'un ni l'autre, la requête est refusée avec `402` et rien n'est débité. Il n'existe **pas** de crédit d'essai pour l'API.

Les offres et leurs prix sont publiés sur [tuk-ai.com/pricing](https://tuk-ai.com/pricing), la seule grille à jour. Cette documentation ne recopie aucun prix.

## Recharger

1. Sur [chat.tuk-ai.com/pay/checkout](https://chat.tuk-ai.com/pay/checkout), choisissez une offre et un moyen de paiement.
2. Pour un paiement en ligne, le compte est crédité quand le prestataire de paiement confirme la transaction à Tukai, pas quand votre navigateur revient sur la page.
3. Pour un virement ou un paiement à valider, déposez le justificatif demandé. La commande reste **en attente de validation** tant que Tukai ne l'a pas confirmée : vous pouvez préparer votre intégration, mais les appels payants restent refusés jusqu'au crédit du compte.

Vos commandes, leur état et leurs reçus sont dans [chat.tuk-ai.com/subscription](https://chat.tuk-ai.com/subscription).

## Ce qui se passe à chaque appel

1. **Contrôle** : abonnement ou crédits, modèle autorisé, limites de l'offre et de la clé.
2. **Réservation** : avant la génération, Tukai réserve une estimation du coût de l'appel. Le montant réservé n'est plus disponible pour d'autres usages pendant l'appel.
3. **Génération**.
4. **Règlement** : le coût définitif est calculé d'après la consommation réelle, puis la réservation est soldée. Ce calcul peut arriver **après** la réponse : pendant ce délai, le coût de l'appel est en cours de calcul.

Un refus n'est pas facturé, ni une erreur avant le premier mot généré. Une erreur après le début de la génération est facturée au prorata de ce qui a été produit. Voir [Erreurs](https://developers.tuk-ai.com/docs/errors#ce-qui-est-facturé).

## Plafond mensuel par clé

Chaque clé peut porter un plafond mensuel en dinars, fixé à sa création ou modifié ensuite dans l'onglet **Clés API**. Il est **appliqué par Tukai** avant chaque appel de génération (`/v1/chat/completions` et `/v1/messages`) :

- le mois est le **mois civil en temps universel (UTC)** : le compteur repart le 1er à 00 h 00 UTC, soit 01 h 00 à Tunis ;
- avant chaque génération, Tukai réserve contre le plafond le coût le plus élevé possible de l'appel, la sortie étant bornée par votre `max_tokens` et par le plafond de sortie de votre offre ; si cette réserve dépasse le plafond, l'appel est refusé avec `429` ;
- des appels simultanés ne peuvent pas, ensemble, faire admettre plus que le plafond ;
- si le compteur ne peut pas être lu, l'appel est refusé (`503`) plutôt que laissé passer sans compter.

Une petite différence reste possible entre l'estimation de l'entrée et son décompte réel ; elle est bornée et journalisée. Le comptage de tokens (`/v1/messages/count_tokens`) est gratuit et n'est pas compté.

> **Ce que ce plafond ne fait pas**
>
> Il ne protège que la clé qui le porte. Il n'empêche pas l'application, le Studio ou une autre clé de consommer le compte, et il ne réserve aucun montant pour vos applications.

## Ce qui n'existe pas encore

Pour éviter toute mauvaise surprise en production :

- **Pas de plafond de dépense au niveau du compte** réglable par vous, ni d'alerte de dépense envoyée par Tukai.
- **Pas de solde réservé** à l'API : un usage intensif du chat ou du Studio réduit ce qui reste pour vos applications.
- **Pas d'historique par requête** : l'onglet **Utilisation** (groupe **Compte et sécurité**) montre où en sont vos limites d'usage et vos crédits du mois, pas le détail ni le montant de chaque appel API. La consommation n'y est pas distinguée entre application, API et CLI.

Ces limites sont listées dans [Mise en production](https://developers.tuk-ai.com/docs/production) avec la manière de s'en accommoder.