Limites de débit

Combien de requêtes vous pouvez envoyer, ce qui se passe au-delà, et les autres limites à connaître.

Les limites protègent tous ceux qui partagent le service. Les valeurs par défaut sont larges pour un usage normal ; si vous en atteignez une, la réponse vous dit exactement combien de temps attendre.

En un coup d’œil

Limite	Par défaut	Quand vous l’atteignez
Écritures par compte (`createTask`, `retry`, envois …)	1 000 par 10 secondes	`429` avec `Retry-After`
Lectures par compte (`recordInfo`, `models`, `jobs`, `quote` …)	1 000 par 10 secondes	`429` avec `Retry-After`
Tickets d’envoi	1 000 par 10 secondes, en plus des écritures	`429` avec `Retry-After`
Rapport d’usage (`/api/v1/usage`)	30 par minute et par compte	`429` avec `Retry-After`
Bibliothèque de ressources	60 lectures et 30 enregistrements par minute, plus un nombre quotidien de nouvelles ressources	`429` avec `Retry-After`
Toute requête, avant la vérification de la clé	6 000 par minute et par réseau	`429`
Corps de requête	2 Mio de JSON	`413`
Solde	Ce qu’il y a sur votre compte	`40201`
Plafonds de dépense des clés	Aucun, sauf si vous en définissez	`40202`

Les limites se comptent par compte, pas par clé : créer d’autres clés ne les augmente pas.

En-têtes de réponse

En-tête	Signification
`X-RateLimit-Limit`	Votre quota pour la fenêtre en cours
`X-RateLimit-Remaining`	Ce qu’il en reste — envoyé aussi sur les réponses réussies, pour ralentir à temps
`Retry-After`	Sur un `429` : nombre de secondes à attendre avant de réessayer

Les chiffres ci-dessus sont des valeurs par défaut susceptibles d’évoluer ; fiez-vous aux en-têtes plutôt que de les coder en dur.

À quoi ressemble une limite

{ "code": 429, "msg": "Too many requests. Retry in a moment", "request_id": "req_…" }

Une requête au-delà de la limite est refusée immédiatement — pas mise en file d’attente — et ne coûte rien.

Comment réagir

Attendez au moins Retry-After secondes, puis réessayez. Ajoutez un peu d’aléa pour qu’un lot de clients ne revienne pas au même instant.
Quand vous réessayez createTask, envoyez le même Idempotency-Key (Idempotence).
Interrogez avec modération : toutes les quelques secondes pour les images, toutes les 10 à 15 secondes pour la vidéo. Mieux encore, utilisez les webhooks : ils ne consomment aucune requête.

Lancer beaucoup de tâches à la fois

Les limites de débit plafonnent la vitesse à laquelle vous envoyez des requêtes, pas le nombre de tâches qui tournent en même temps. Vous pouvez en avoir beaucoup en cours ; les longues vidéos prennent simplement plus de temps. Pour lancer des milliers de tâches, étalez les envois et laissez les webhooks rapporter les résultats.

Besoin d’un quota plus élevé pour un lancement ou un gros lot ? Contactez-nous avec le volume prévu.