Snelheidslimieten

Snelheidslimieten 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.


Waarom Limieten

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

  • Om onze service veilig en gezond te houden! Denk aan snelheidslimieten als vriendelijke uitsmijters - ze zorgen ervoor dat niemand onze API kan overweldigen met te veel aanvragen tegelijk. Dit helpt onze service te beschermen tegen mogelijk misbruik en houdt alles soepel draaiend.

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

  • Om de prestaties snel en betrouwbaar te houden. Door de algehele stroom van aanvragen te beheren, kunnen we snelle responstijden en stabiele service voor al onze geweldige gebruikers handhaven. Het is als ervoor zorgen dat een snelweg niet te druk wordt - het verkeer stroomt beter als we congestie voorkomen!


Hoe Limieten Werken

Snelheidslimieten worden op 2 manieren gemeten:

  • Aanvragen per seconde: Dit is het aantal netwerkverzoeken dat je per seconde kunt doen.
  • Wachtrijtaken: Dit is het aantal gelijktijdige generatietaken dat je op elk moment in de wachtrij kunt uitvoeren.

Wachtrijtaken omvatten Tekst naar 3D, Afbeelding naar 3D, Tekst naar textuur, en Remesh endpoints. Andere endpoints zoals Upload en Balance zijn niet inbegrepen in deze limiet.

De limieten worden toegepast op basis van een per-account basis. Dit betekent dat de limieten worden gedeeld over al je API keys.

Naast snelheidslimieten zal de prioriteit van taakverwerking ook de snelheid van je taken beïnvloeden.

Elk gebruikersniveau heeft specifieke snelheidslimieten en prioriteitsniveaus die zijn ontworpen om aan hun behoeften te voldoen. Hier zijn de huidige limieten per niveau:

GebruikersniveauAanvragen per secondeWachtrijtakenPrioriteitsniveau
Pro2010Standaard
Premium2030Hoger dan Pro
Ultra20100Hoogste
Studio2020Hoger dan Pro
Enterprise100Standaard tot 50, kan worden aangepastHoogste

Als je deze limieten overschrijdt, ontvang je een 429 Too Many Requests reactie van onze API. Er zijn twee soorten hits die dit kunnen veroorzaken, elk met een andere reactie:

  • Aanvraaghit: Dit gebeurt wanneer je te veel aanvragen per seconde doet. Je ontvangt een 429 Too Many Requests reactie met een RateLimitExceeded bericht.
  • Wachtrijhit: Dit gebeurt wanneer je te veel gelijktijdige generatietaken hebt draaien. Je ontvangt een 429 Too Many Requests reactie met een NoMoreConcurrentTasks bericht.