# Mise en production

> La liste de contrôle avant de servir de vrais utilisateurs - clés, solde partagé, limites réelles, erreurs, données, support - et le cas des agences.

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

## Liste de contrôle

- **Une clé dédiée** à l'application de production, distincte de vos clés d'essai et de développement.
- La clé est **côté serveur** uniquement (variable d'environnement ou gestionnaire de secrets), jamais dans un navigateur ni une application mobile.
- La clé n'autorise **que les modèles utilisés** par l'application.
- Un **plafond mensuel** est fixé sur la clé, à un niveau que vous acceptez de perdre en cas de fuite.
- Les **droits du compte** sont suivis (crédits, limites d'usage de l'offre) : ils sont partagés avec l'application et le Studio, et rien ne les réserve à votre application (voir ci-dessous).
- Votre code gère `402` (solde), `429` (débit ou limites) et `5xx`, avec des nouvelles tentatives bornées et espacées — voir [Erreurs](https://developers.tuk-ai.com/docs/errors).
- Les délais d'attente côté client sont **longs** : une génération peut durer plus d'une minute. Une relance trop rapide produit une seconde génération facturée.
- Vous journalisez l'en-tête `x-request-id` de chaque réponse, sans journaliser la clé.
- Vous savez comment **révoquer** la clé et en déployer une nouvelle rapidement.
- Le modèle choisi existe toujours dans le [catalogue](https://developers.tuk-ai.com/models), et vous avez prévu quoi faire s'il est retiré : Tukai ne remplace jamais un modèle par un autre en silence.

## Les limites réelles

| Limite | Valeur | Appliquée par |
|---|---|---|
| Débit par clé, génération | 30 requêtes par minute | L'API (en-têtes `ratelimit-*`) |
| Débit par clé, comptage de tokens | 300 requêtes par minute | L'API |
| Plafond mensuel par clé | Celui que vous fixez | L'API, avant chaque appel de génération (mois civil UTC) |
| Limites d'usage de votre offre | Celles de votre abonnement | L'API, comme pour le chat : partagées avec l'application |
| Solde du compte | Votre solde | L'API (`402` quand il est épuisé) |

Il n'existe **pas** aujourd'hui de plafond de dépense au niveau du compte, d'alerte de dépense, ni de solde réservé à l'API. Conséquence pratique : si l'application de production est critique, réservez-lui un compte Tukai qui ne sert à rien d'autre.

## Données

Ce qui arrive au contenu de vos requêtes, ce qui est conservé et ce qui ne l'est pas : voir [Données](https://developers.tuk-ai.com/docs/data). Pour un usage sensible, écrivez au support **avant** d'envoyer des données.

## Agences et prestataires

Si vous développez pour un client :

- Le compte Tukai, le solde et les clés de production doivent appartenir **au client**. Créez les clés depuis son compte, jamais depuis le vôtre.
- Ne partagez jamais votre propre clé avec un client, et ne réutilisez pas la clé d'un client pour un autre.
- À la remise du projet, le client révoque les clés que vous avez manipulées et en crée de nouvelles.
- Les [conditions d'utilisation](https://tuk-ai.com/legal/terms) prévoient une facture à chaque transaction, et une facture au nom d'une société sur demande.

## Support et état du service

- Support : [service-client@tukhnanutha.com](mailto:service-client@tukhnanutha.com) ou +216 22 450 577. Aucun délai de réponse n'est garanti.
- Il n'existe pas encore de page d'état public du service. Une suite d'erreurs `503` ou `504` est à signaler au support avec les `x-request-id` concernés.