# Limites et quotas L'API est gratuite ; ses plafonds servent de garde-fou. Le plan est attribué par Kelki et peut être relevé au cas par cas. ## Plafonds par plan | Plan | Requêtes / min (par clé) | Requêtes / jour (par compte) | Demandes réelles / jour | Messages à l'Agent / jour | Webhooks | | `decouverte` (bac à sable seul) | 30 | 2 000 | 0 | 50 | 2 | | `standard` | 120 | 20 000 | 50 | 500 | 5 | | `partenaire` | 600 | 200 000 | 500 | 5 000 | 10 | Votre plan, vos plafonds et votre consommation : `GET /account` et `GET /account/usage` (92 jours au plus). ## Limites communes - Par adresse IP, avant authentification : 120 requêtes par minute. - Anti-force brute : au-delà de 20 clés refusées en 10 minutes, l'adresse IP est bloquée temporairement. - Par contact : 3 demandes au plus par 24 heures pour un même téléphone ou une même adresse e-mail, tous canaux de Kelki confondus (`contact_limit_reached`). - Plafond global : 200 demandes API à confirmer par heure, tous comptes confondus. Ne contournez pas ces limites (plusieurs comptes, clés multipliées, rotation d'adresses) : c'est interdit par la [politique d'usage acceptable](https://kelki.ai/developers/fr/terms/acceptable-use/). ## En-têtes ``` RateLimit-Policy: "minute";q=120;w=60 RateLimit: "minute";r=118;t=42 ``` `RateLimit-Policy` décrit la politique appliquée à la clé, `RateLimit` le quota restant (brouillon IETF `draft-ietf-httpapi-ratelimit-headers`). ## Sur une réponse 429 - `rate_limited` : débit par minute dépassé ; attendez la durée de `Retry-After`, en secondes, avant de réessayer. - `quota_exceeded` : quota du jour atteint ; inutile de réessayer avant le lendemain. - Espacez les nouveaux essais (attente croissante) et ne relancez jamais une création sans le même `Idempotency-Key` ([idempotence](https://kelki.ai/developers/fr/idempotency/)). ## Sur cette page - URL : https://kelki.ai/developers/fr/rate-limits/ - Langue : fr - fr : https://kelki.ai/developers/fr/rate-limits/ - en : https://kelki.ai/developers/en/rate-limits/ - x-default : https://kelki.ai/developers/ - Portail : https://kelki.ai/developers/llms.txt