Passer au contenu principal

Comment corriger les erreurs 429 et de limite de débit de l'API Meshy

Limites de débit de l'API Meshy : corriger les erreurs 429

Table des matières

Si votre intégration rencontre des erreurs 429, RateLimitExceeded ou NoMoreConcurrentTasks lors des appels à l'API Meshy, ce guide explique pourquoi ces limites existent et comment concevoir votre intégration pour les respecter.

Pourquoi les limites de débit existent

L'API Meshy s'appuie sur une puissance de calcul GPU partagée utilisée pour générer des modèles 3D, des textures et des ressources associées. Les limites de débit et les plafonds de concurrence protègent cette infrastructure partagée afin que la qualité de génération et les délais de traitement restent constants pour tous les utilisateurs de la plateforme. Chaque compte, selon son forfait actuel, dispose d'un nombre maximal de requêtes qu'il peut effectuer dans une fenêtre de temps donnée et d'un nombre maximal de tâches de génération qu'il peut avoir en cours d'exécution (en file d'attente ou en cours) simultanément.

Limite de requêtes vs limite de file d'attente/concurrence

Il existe deux limites distinctes, qui échouent de manières différentes :

  • Limite de débit de requêtes (429 / RateLimitExceeded) : elle plafonne le nombre d'appels API (par exemple, création de tâche, interrogation du statut) que vous pouvez effectuer par minute. La dépasser signifie que vous appelez l'API trop fréquemment, indépendamment du nombre de tâches réellement en cours d'exécution.

  • Limite de concurrence / file d'attente (NoMoreConcurrentTasks) : elle plafonne le nombre de tâches de génération que vous pouvez avoir en file d'attente ou en cours de traitement en même temps. La dépasser signifie que vous avez déjà atteint le nombre maximal de tâches actives et devez attendre qu'une tâche se termine avant d'en soumettre une autre.

Consultez les limites de débit de requêtes et de concurrence actuelles de votre forfait dans votre tableau de bord Meshy, car elles peuvent varier selon le niveau de forfait.

Stratégie de backoff pour les erreurs 429

Lorsque vous recevez une réponse 429 ou RateLimitExceeded, ne réessayez pas immédiatement la même requête. À la place :

  • Utilisez un backoff exponentiel : attendez un court intervalle, puis doublez-le à chaque échec suivant, jusqu'à un maximum raisonnable.

  • Ajoutez du jitter (un petit décalage aléatoire) à votre intervalle de backoff afin que plusieurs workers de votre système ne réessaient pas tous au même instant.

  • Respectez les éventuels en-têtes Retry-After ou de limite de débit renvoyés dans la réponse, s'ils sont présents, plutôt que de deviner un temps d'attente.

  • Limitez le nombre de nouvelles tentatives par requête afin qu'un échec persistant ne boucle pas indéfiniment.

Planifier autour des limites de concurrence

Une erreur NoMoreConcurrentTasks signifie que vous avez déjà atteint le plafond de tâches actives de votre compte. Pour éviter de l'atteindre en production :

  • Maintenez une file d'attente locale ou un ordonnanceur de tâches dans votre propre application, qui ne soumet une nouvelle tâche de génération qu'une fois une précédente terminée ou lorsque votre nombre de tâches actives redescend sous la limite.

  • Interrogez l'état des tâches (ou utilisez des webhooks, si votre workflow le permet) pour savoir quand un emplacement se libère, plutôt que de soumettre des requêtes à l'aveugle.

  • Regroupez et limitez le débit des tâches de génération en masse au lieu d'envoyer toutes les requêtes en une seule fois — cela lisse à la fois votre débit de requêtes et votre nombre de tâches simultanées.

  • Mettez en place une supervision et des alertes de votre côté afin qu'un pic d'erreurs 429/NoMoreConcurrentTasks soit visible avant d'affecter vos utilisateurs.

Réessayer les générations échouées ou insatisfaisantes

L'API Meshy ne prend actuellement pas en charge de « nouvelle tentative » intégrée d'une génération existante pour les forfaits individuels ou studio — si un résultat ne correspond pas à vos attentes, vous soumettez une nouvelle demande de génération, ce qui consomme des crédits comme d'habitude. Lorsque votre pipeline automatisé gère des erreurs transitoires (comme une 429), assurez-vous que votre logique de nouvelle tentative ne renvoie la requête d'origine qu'après un backoff, et ne crée pas de tâches de génération en double à chaque fois.

Quand envisager de mettre à niveau votre forfait

Si vous avez mis en place une stratégie de backoff et une file d'attente tenant compte de la concurrence, et que vous atteignez toujours régulièrement les limites de débit ou de concurrence, cela indique généralement que les besoins en débit de votre intégration ont dépassé les limites de votre forfait actuel. Consultez votre tableau de bord pour connaître les quotas de requêtes et de concurrence de votre forfait actuel, et envisagez de passer à un forfait supérieur ou de contacter l'équipe commerciale de Meshy au sujet d'un accès API de niveau entreprise si vous avez besoin d'un débit plus élevé de façon durable.

FAQ

1. Que signifie une erreur 429 ou RateLimitExceeded ?

Cela signifie que vous avez dépassé le nombre de requêtes API autorisées dans une fenêtre de temps donnée pour votre forfait. Ralentissez votre débit de requêtes et utilisez un backoff exponentiel avant de réessayer.

2. Que signifie NoMoreConcurrentTasks ?

Cela signifie que vous avez déjà atteint le nombre maximal de tâches de génération en file d'attente ou en cours pour votre compte. Attendez qu'une tâche existante se termine ou réduisez le nombre de tâches que vous soumettez en une fois avant d'en soumettre davantage.

3. Comment connaître les limites de débit et de concurrence de mon compte ?

Consultez votre tableau de bord Meshy pour connaître les limites associées à votre forfait actuel, car elles peuvent varier selon le niveau de forfait.

4. Meshy prend-il en charge les nouvelles tentatives automatiques pour les tâches de génération ?

Non, pas pour les forfaits Individual ou Studio — une génération échouée ou insatisfaisante doit être soumise à nouveau en tant que nouvelle requête, ce qui consomme normalement des crédits. Les clients de l'offre Enterprise doivent contacter le service commercial au sujet de la fonctionnalité de nouvelle tentative.

5. Quelle est la meilleure façon d'éviter ces erreurs dans un pipeline de production ?

Mettez en place une file d'attente locale qui limite les soumissions afin de rester sous votre limite de concurrence, ajoutez un backoff exponentiel avec jitter pour toute réponse 429, et surveillez les taux d'erreur afin de pouvoir réagir avant qu'ils n'affectent vos utilisateurs.

6. Quand dois-je mettre à niveau mon forfait à cause des limites de débit ?

Si vous avez déjà mis en place un backoff et une file d'attente tenant compte de la concurrence et que vous atteignez toujours régulièrement ces limites, votre utilisation dépasse probablement votre forfait actuel — consultez votre tableau de bord ou contactez le service commercial pour un forfait à débit plus élevé.


Articles connexes

Cet article a-t-il répondu à votre question ?