Crédits et facturation

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, la seule grille à jour. Cette documentation ne recopie aucun prix.

Recharger

1. Sur 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.

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.

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 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 avec la manière de s'en accommoder.