Rate Limits

Rate limits zijn beperkingen die onze API oplegt aan het aantal keren dat een gebruiker of client toegang kan krijgen tot onze diensten binnen een bepaalde periode.

---

Why Limits

We hebben rate limits ingesteld op onze API om voor iedereen de beste ervaring te creëren. Hier is waarom ze belangrijk zijn:

• Om onze dienst veilig en gezond te houden! Zie rate limits als vriendelijke portiers - ze zorgen ervoor dat niemand onze API kan overweldigen met te veel aanvragen tegelijk. Dit helpt onze dienst te beschermen tegen mogelijk misbruik en houdt alles soepel draaiende.

• Om ervoor te zorgen dat iedereen zijn eerlijke deel krijgt. Net als het delen van speelgoed op een speelplaats, willen we ervoor zorgen dat al onze gebruikers gelijke toegang hebben tot de API. Door het aantal aanvragen dat elke gebruiker kan doen zachtjes te beperken, zorgen we ervoor dat niemand te lang hoeft te wachten op zijn beurt.

• Om de prestaties vlot en betrouwbaar te houden. Door de algehele stroom van aanvragen te beheren, kunnen we snelle responstijden en stabiele service voor al onze geweldige gebruikers behouden. Het is alsof je ervoor zorgt dat een snelweg niet te druk wordt - het verkeer verloopt beter wanneer we congestie voorkomen!

---

How Limits Work

Rate limits worden op 2 manieren gemeten:

• aanvragen per seconde: Dit is het aantal netwerkaanvragen dat u per seconde kunt doen.
• wachtrijtaken: Dit is het aantal gelijktijdige generatietaken dat u op elk moment in de wachtrij kunt laten draaien.

wachtrijtaken zijn de taken op uw account die PENDING of IN_PROGRESS zijn. Elke endpoint die een taak aanmaakt (bijvoorbeeld Tekst naar 3D, Afbeelding naar 3D, Multi-afbeelding naar 3D, Hertextureren, Remesh, Rigging, Animatie, Tekst naar afbeelding, de 3D-printen endpoints en Creative Lab) controleert deze limiet voordat een nieuwe taak wordt geaccepteerd. Aanvragen die geen taak aanmaken, zoals Balance, Usage, en het ophalen, weergeven of streamen van taken, tellen niet mee voor deze limiet, hoewel ze nog steeds meetellen voor aanvragen per seconde.

De limieten worden per account toegepast, dus ze worden gedeeld over al uw API keys en de Playground. Taken die u start in de Meshy web-app tellen ook mee voor uw wachtrijtaken.

Naast rate limits zal ook de verwerkingsprioriteit van taken de snelheid van uw taken beïnvloeden.

Elk gebruikersniveau heeft specifieke rate limits en prioriteitsniveaus die zijn afgestemd op hun behoeften. Hier zijn de huidige limieten per niveau:

Als u deze limieten overschrijdt, ontvangt u een 429 Too Many Requests antwoord van onze API. Er zijn twee soorten overschrijdingen die dit kunnen veroorzaken, elk met een ander antwoord:

• Aanvraag-overschrijding: Dit gebeurt wanneer u te veel aanvragen per seconde doet. U ontvangt een 429 Too Many Requests antwoord met een Rate limit exceeded bericht.
• Wachtrij-overschrijding: Dit gebeurt wanneer u te veel gelijktijdige generatietaken heeft draaien. U ontvangt een 429 Too Many Requests antwoord met een NoMorePendingTasks (of, wanneer uw credits op zijn, NoMoreConcurrentTasks) bericht. Deze 429 heeft geen Retry-After: wacht tot een van uw taken klaar is voordat u een nieuwe aanmaakt.

---

Rate Limit Headers

API-antwoorden bevatten deze headers zodat u uw aanvragen kunt doseren:

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