Limites de débit

Vérifiez combien de requêtes et de tâches votre forfait autorise, et ce qu'il faut faire lorsque vous atteignez une limite.

Limites par forfait

Pour garder l'API rapide et disponible pour tous, Meshy limite chaque compte de deux manières :

Requêtes par seconde : combien de requêtes API vous pouvez envoyer chaque seconde.
Tâches simultanées : combien de vos tâches peuvent être PENDING ou IN_PROGRESS en même temps.

Les limites dépendent de votre forfait :

Forfait	Requêtes par seconde	Tâches simultanées	Priorité
Pro	20	10	Par défaut
Premium	20	30	Plus élevée que Pro
Ultra	20	100	La plus élevée
Studio	20	60, ou 20 sur certains anciens forfaits Studio	Plus élevée que Pro
Enterprise	100	100 par défaut, ou une limite personnalisée	La plus élevée

La priorité n'est pas une limite. Lorsque la file d'attente est occupée, Meshy démarre d'abord les tâches ayant une priorité plus élevée.

Ce qui compte dans chaque limite

Chaque requête API compte dans le calcul des requêtes par seconde, y compris les requêtes qui récupèrent, listent ou diffusent des tâches. Les requêtes provenant de l'application web Meshy ne comptent pas.

La limite de tâches simultanées compte les tâches, pas les requêtes. Chaque point de terminaison qui crée une tâche vérifie cette limite avant d'en créer une. Par exemple, Texte en 3D, Image en 3D, Multi-image en 3D, Retexturisation, Remaillage, Rigging, Animation, Texte en image, les points de terminaison d'impression 3D, et Creative Lab la vérifient.

Les requêtes qui ne créent pas de tâche ne comptent pas dans cette limite. Par exemple, Balance, Usage, et les requêtes qui récupèrent, listent ou diffusent des tâches ne comptent pas.

À qui les limites s'appliquent

Le tableau suivant montre les limites auxquelles vos clés API, le Playground et l'application web contribuent :

Où vous travaillez	Compte personnel	Équipe
Clés API	Vos limites	Les limites de l'équipe, partagées par chaque clé API de l'équipe
Playground	Vos limites	Vos propres limites en tant que membre connecté
Application web	Vos tâches simultanées	Vos propres tâches simultanées. Les tâches lancées par le propriétaire de l'équipe comptent aussi dans les limites de l'équipe.

Lorsque vous atteignez une limite

Lorsque vous dépassez une limite, l'API renvoie 429 Too Many Requests. Le message indique quelle limite vous avez atteinte :

Trop de requêtes par seconde : le message est Rate limit exceeded. Attendez le nombre de secondes indiqué dans l'en-tête Retry-After, puis réessayez.
Trop de tâches simultanées : le message commence par NoMorePendingTasks. Sur un forfait illimité sans crédits restants, il commence par NoMoreConcurrentTasks. Ce 429 n'a pas d'en-tête Retry-After. Attendez qu'une de vos tâches se termine, puis créez la suivante.

En-têtes de limite de débit

Les réponses de l'API incluent ces en-têtes pour vous aider à rythmer vos requêtes :

En-tête	Description
`X-RateLimit-Limit`	Requêtes autorisées par seconde sur votre forfait.
`X-RateLimit-Remaining`	Requêtes restantes pour la seconde en cours.
`X-RateLimit-Reset`	Secondes avant que votre budget ne soit à nouveau complet.
`Retry-After`	Secondes à attendre avant votre prochaine requête. Envoyé avec un `429` en cas de trop grand nombre de requêtes par seconde, et lorsque vous récupérez une tâche encore `PENDING` ou `IN_PROGRESS`.

Lorsque Retry-After est présent, attendez ce nombre de secondes avant d'envoyer la requête suivante.