Notions clés
Limites de débit
L’API limite le nombre de requêtes par minute et le nombre de générations lancées par minute et par heure. Les limites d’une organisation dépendent de son palier (voir Tarifs).
- Par organisation : la valeur de la colonne « Requêtes/min » des paliers, commune à toutes les clés de l’organisation, de test comme réelles. Chaque message envoyé au serveur MCP compte pour une requête ; un client MCP en envoie trois ou quatre avant son premier appel d’outil.
- Par adresse IP : 600 requêtes par minute, comptées avant la vérification de la clé, requêtes non authentifiées comprises.
- Le compteur porte sur une fenêtre d’une minute, ouverte par la première requête, et repart de zéro à la fenêtre suivante.
- Au-delà, l’API répond
429 rate_limit_exceeded, avec le délai d’attente en secondes dans l’en-têteRetry-After.
Chaque réponse à une requête authentifiée porte ces en-têtes :
| En-tête | Description | Exemple |
|---|---|---|
x-ratelimit-limit-requests | Requêtes permises par minute | 30 |
x-ratelimit-remaining-requests | Requêtes restantes dans la fenêtre | 27 |
x-ratelimit-reset-requests | Délai avant la fenêtre suivante | 42s |
- Le quota dépend du palier (colonnes « Générations/min » et « Générations/h » des paliers) et se compte sur une minute et sur une heure glissantes. Le mode test et le mode réel ont chacun leur quota.
- Une génération compte dès son acceptation, même si elle échoue ou est annulée ensuite. Une requête refusée à l’entrée (paramètre invalide, modération, solde, plafond, affluence) ne compte pas.
/v1, le serveur MCP et le bac à sable de la console partagent ce quota.- Au-delà, l’API répond
429 generation_rate_limit_exceeded, avec dansRetry-Afterle délai en secondes avant qu’une génération puisse être lancée. Rien n’est créé ni débité. - Le nombre de générations en cours à la fois n’est pas limité.
Chaque réponse à une création acceptée porte ces en-têtes :
| En-tête | Description | Exemple |
|---|---|---|
x-ratelimit-limit-generations-minute | Générations permises par minute | 5 |
x-ratelimit-remaining-generations-minute | Restantes sur la dernière minute, celle-ci comprise | 4 |
x-ratelimit-limit-generations-hour | Générations permises par heure | 50 |
x-ratelimit-remaining-generations-hour | Restantes sur la dernière heure, celle-ci comprise | 37 |
En forte affluence, une création de rendu, d’édition ou de décoration en mode réel peut être refusée à l’entrée, quelles que soient les limites de l’organisation. L’API répond alors
503 overloaded, avec un en-tête Retry-After de 30 à 300 secondes. Rien n’est débité.- Ralentissez avant que
x-ratelimit-remaining-requestsoux-ratelimit-remaining-generations-minuten’atteigne zéro. - Pour attendre la fin d’une génération, préférez la création synchrone ou un webhook à des lectures répétées.
- Mettez en cache les styles et les matériaux d’édition : une lecture par jour suffit.