Naar hoofdinhoud

Hoe Meshy API 429- en rate limit-fouten oplossen

Meshy API-ratebeperkingen: 429-fouten oplossen

Inhoudsopgave

Als je integratie bij het aanroepen van de Meshy API 429-, RateLimitExceeded- of NoMoreConcurrentTasks-fouten tegenkomt, legt deze gids uit waarom deze limieten bestaan en hoe je je integratie ontwerpt om binnen deze limieten te werken.

Waarom rate limits bestaan

De Meshy API staat voor gedeelde GPU-rekenkracht die wordt gebruikt om 3D-modellen, textures en gerelateerde assets te genereren. Rate limits en concurrency-limieten beschermen die gedeelde infrastructuur, zodat de generatiekwaliteit en doorlooptijd consistent blijven voor elke gebruiker op het platform. Elk account heeft, op basis van het huidige plan, een maximaal aantal requests dat het binnen een bepaald tijdvenster kan doen en een maximaal aantal generatietaken dat tegelijkertijd actief kan zijn (in de wachtrij of in uitvoering).

Request limit versus wachtrij/concurrency limit

Er zijn twee verschillende limieten, en ze treden op een andere manier op:

  • Request rate limit (429 / RateLimitExceeded): deze limiet bepaalt hoeveel API-aanroepen (bijv. taken aanmaken, status opvragen) je per minuut mag doen. Als je deze overschrijdt, roep je de API te vaak aan, ongeacht hoeveel taken er daadwerkelijk worden uitgevoerd.

  • Concurrency-/wachtrijlimiet (NoMoreConcurrentTasks): deze limiet bepaalt hoeveel generatietaken je tegelijk in de wachtrij kunt hebben staan of kunt verwerken. Als je deze overschrijdt, heb je al het maximale aantal actieve taken en moet je wachten tot er één is voltooid voordat je een nieuwe indient.

Controleer de huidige request- en concurrencylimieten van je plan in je Meshy-dashboard, want deze kunnen per plantype verschillen.

Backoff-strategie voor 429-fouten

Wanneer je een 429- of RateLimitExceeded-response ontvangt, moet je hetzelfde verzoek niet meteen opnieuw proberen. Doe in plaats daarvan het volgende:

  • Gebruik exponentiële backoff: wacht een korte periode en verdubbel die periode bij elke volgende mislukking, tot een redelijk maximum.

  • Voeg jitter toe (een kleine willekeurige afwijking) aan je backoff-interval, zodat meerdere workers in je systeem niet allemaal op hetzelfde moment opnieuw proberen.

  • Respecteer eventuele Retry-After- of rate-limit-headers in de response, als die aanwezig zijn, in plaats van een wachttijd te raden.

  • Beperk het aantal herhaalpogingen per verzoek, zodat een aanhoudende fout niet eindeloos blijft doorlopen.

Plannen rondom concurrency limits

Een NoMoreConcurrentTasks-fout betekent dat je al aan het maximum aantal actieve taken van je account zit. Om dit in productie te voorkomen:

  • Onderhoud een lokale wachtrij of job scheduler in je eigen applicatie die pas een nieuwe generatietaak indient wanneer een vorige is voltooid of je actieve aantal onder de limiet zakt.

  • Poll de taakstatus (of gebruik webhooks, als je workflow dat ondersteunt) om te weten wanneer er een slot vrijkomt, in plaats van speculatief in te dienen.

  • Batch en throttle bulkgeneratietaken in plaats van alle requests tegelijk te versturen — dit vlakt zowel je request rate als je aantal gelijktijdige taken af.

  • Bouw monitoring/alerting aan jouw kant in, zodat een piek in 429-/NoMoreConcurrentTasks-fouten zichtbaar is voordat deze je gebruikers raakt.

Mislukte of onbevredigende generaties opnieuw proberen

De Meshy API ondersteunt momenteel geen ingebouwde "retry" van een bestaande generatie voor individuele plannen of studio-abonnementen — als een resultaat niet aan je verwachtingen voldoet, dien je een nieuwe generatieaanvraag in, die zoals gebruikelijk credits verbruikt. Zorg ervoor dat je retry-logica, wanneer je geautomatiseerde pipeline tijdelijke fouten afhandelt (zoals een 429), alleen het oorspronkelijke verzoek opnieuw verstuurt na een backoff, en niet telkens dubbele generatietaken aanmaakt.

Wanneer overwegen om je plan te upgraden

Als je backoff en concurrency-bewuste queuing hebt geïmplementeerd en nog steeds consistent tegen rate- of concurrencylimieten aanloopt, is dat meestal een teken dat de doorvoerbehoeften van je integratie de limieten van je huidige plan zijn ontgroeid. Controleer in je dashboard de request- en concurrencylimieten van je huidige plan en overweeg een upgrade of neem contact op met het Meshy-verkoopteam over API-toegang op enterprise-niveau als je structureel hogere doorvoer nodig hebt.

FAQ

1. Wat betekent een 429- of RateLimitExceeded-fout?

Het betekent dat je het aantal API-requests dat binnen een bepaald tijdvenster voor jouw plan is toegestaan, hebt overschreden. Verlaag je requestfrequentie en gebruik exponentiële backoff voordat je het opnieuw probeert.

2. Wat betekent NoMoreConcurrentTasks?

Het betekent dat je al het maximale aantal generatietaken in de wachtrij of in uitvoering hebt voor je account. Wacht tot een bestaande taak is voltooid, of verminder het aantal taken dat je tegelijk indient, voordat je meer taken indient.

3. Hoe kom ik achter de rate- en concurrencylimieten van mijn account?

Controleer je Meshy-dashboard voor de limieten die bij je huidige plan horen, want deze kunnen verschillen per plantier.

4. Ondersteunt Meshy automatische herhaalpogingen voor generatietaken?

Nee, niet voor individuele of studio-abonnementen — een mislukte of onbevredigende generatie moet opnieuw worden ingediend als een nieuwe aanvraag, wat normaal gesproken credits kost. Enterprise-klanten kunnen contact opnemen met sales over functionaliteit voor opnieuw proberen.

5. Wat is de beste manier om deze fouten in een productiepipeline te voorkomen?

Implementeer een lokale wachtrij die inzendingen afremt om onder je concurrencylimit te blijven, voeg exponentiële backoff met jitter toe voor eventuele 429-responses, en monitor foutpercentages zodat je kunt reageren voordat ze je gebruikers raken.

6. Wanneer moet ik upgraden vanwege rate limits?

Als je al backoff en concurrencybewuste wachtrijing hebt geïmplementeerd en deze limieten nog steeds regelmatig raakt, is je gebruik waarschijnlijk je huidige plan ontgroeid — controleer je dashboard of neem contact op met sales over een plan met hogere doorvoer.


Gerelateerde artikelen

Is hiermee je vraag beantwoord?