Rate limits

Bekijk hoeveel aanvragen en taken je abonnement toestaat, en wat je moet doen wanneer je een limiet bereikt.

Limieten per abonnement

Om de API snel en beschikbaar te houden voor iedereen, beperkt Meshy elk account op twee manieren:

Aanvragen per seconde: hoeveel API-aanvragen je elke seconde kunt versturen.
Gelijktijdige taken: hoeveel van je taken tegelijk PENDING of IN_PROGRESS kunnen zijn.

De limieten zijn afhankelijk van je abonnement:

Abonnement	Aanvragen per seconde	Gelijktijdige taken	Prioriteit
Pro	20	10	Standaard
Premium	20	30	Hoger dan Pro
Ultra	20	100	Hoogste
Studio	20	60, of 20 bij sommige eerdere Studio-abonnementen	Hoger dan Pro
Enterprise	100	Standaard 100, of een aangepaste limiet	Hoogste

Prioriteit is geen limiet. Wanneer de wachtrij druk is, start Meshy eerst de taken met een hogere prioriteit.

Wat meetelt voor elke limiet

Elke API-aanvraag telt mee voor aanvragen per seconde, inclusief aanvragen die taken ophalen, weergeven of streamen. Aanvragen vanuit de Meshy web-app tellen niet mee.

De limiet voor gelijktijdige taken telt taken, niet aanvragen. Elke endpoint die een taak aanmaakt, controleert deze limiet voordat er een taak wordt aangemaakt. Zo controleren bijvoorbeeld Tekst naar 3D, Afbeelding naar 3D, Multi-afbeelding naar 3D, Hertextureren, Remesh, Rigging, Animatie, Tekst naar afbeelding, de endpoints voor 3D-printen, en Creative Lab deze limiet.

Aanvragen die geen taak aanmaken, tellen hier niet voor mee. Zo tellen Balance, Usage en aanvragen die taken ophalen, weergeven of streamen bijvoorbeeld niet mee.

Van wie de limieten gelden

De volgende tabel toont van wie de limieten gelden waartoe je API-sleutels, de Playground en de web-app bijdragen:

Waar je werkt	Persoonlijk account	Team
API-sleutels	Jouw limieten	De limieten van het team, gedeeld door elke API-sleutel in het team
Playground	Jouw limieten	Je eigen limieten als ingelogd teamlid
Web-app	Jouw gelijktijdige taken	Je eigen gelijktijdige taken. Taken die de teameigenaar start, tellen ook mee voor de limieten van het team.

Wanneer je een limiet bereikt

Wanneer je een limiet overschrijdt, retourneert de API 429 Too Many Requests. Het bericht vertelt je welke limiet je hebt bereikt:

Te veel aanvragen per seconde: het bericht is Rate limit exceeded. Wacht het aantal seconden dat in de Retry-After-header staat en probeer het opnieuw.
Te veel gelijktijdige taken: het bericht begint met NoMorePendingTasks. Bij een onbeperkt abonnement zonder resterende credits begint het met NoMoreConcurrentTasks. Deze 429 heeft geen Retry-After-header. Wacht tot een van je taken is afgerond en maak daarna de volgende aan.

Rate limit headers

API-responses bevatten de volgende headers om je te helpen het tempo van je aanvragen af te stemmen:

Header	Beschrijving
`X-RateLimit-Limit`	Aantal toegestane aanvragen per seconde voor jouw abonnement.
`X-RateLimit-Remaining`	Aantal resterende aanvragen in de huidige seconde.
`X-RateLimit-Reset`	Aantal seconden tot je budget weer vol is.
`Retry-After`	Aantal seconden om te wachten voordat je de volgende aanvraag verstuurt. Wordt meegestuurd bij een `429` voor te veel aanvragen per seconde, en wanneer je een taak ophaalt die nog `PENDING` of `IN_PROGRESS` is.

Wanneer Retry-After aanwezig is, wacht dan dat aantal seconden voordat je de volgende aanvraag verstuurt.