Limites de débit

Les limites gardent l’API rapide pour tout le monde. Elles comptent les requêtes par fenêtres fixes, par clé et par compte.

Limites de requêtes

S’applique à	Limite
Chaque clé d’API	120 requêtes par 60 secondes
Toutes les clés d’un compte ensemble	300 requêtes par 60 secondes

En-têtes

Chaque réponse à une clé d’API indique la plus stricte des deux limites :

RateLimit-Limit: requêtes autorisées dans la fenêtre en cours.
RateLimit-Remaining: requêtes restantes dans la fenêtre en cours.
RateLimit-Reset: secondes avant la réinitialisation de la fenêtre.
RateLimit-Policy: la limite et la fenêtre, par exemple 120;w=60.

Au-delà de la limite, vous recevez 429 avec le code rate_limited et un en-tête Retry-After : attendez ce nombre de secondes avant de réessayer.

HTTP

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
RateLimit-Limit: 120
RateLimit-Remaining: 0
RateLimit-Reset: 17
RateLimit-Policy: 120;w=60
Retry-After: 17

Générations simultanées

En plus des limites de requêtes, 4 générations s’exécutent en même temps par compte (8 après votre premier achat de pièces). Vous pouvez en envoyer davantage : les générations en trop attendent dans la file et démarrent quand d’autres se terminent. GET /v1/generations/concurrency indique la limite et combien s’exécutent ou attendent en ce moment.

N’interrogez pas une génération plus souvent que toutes les 2 secondes, ou utilisez plutôt les webhooks.