Rate limits
Rate limits zijn beperkingen die onze API oplegt aan het aantal keren dat een gebruiker of client binnen een bepaalde periode toegang kan krijgen tot onze diensten.
Waarom limieten
We hebben rate limits ingevoerd voor onze API om voor iedereen de beste ervaring te creëren. Dit is waarom ze belangrijk zijn:
-
Om onze service veilig en stabiel te houden! Zie rate limits als vriendelijke uitsmijters: ze zorgen ervoor dat niemand onze API kan overspoelen 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 eerlijk deel krijgt. Net als speelgoed delen op een speelplaats willen we ervoor zorgen dat al onze gebruikers gelijke toegang hebben tot de API. Door voorzichtig te beperken hoeveel aanvragen elke gebruiker kan doen, zorgen we ervoor dat niemand te lang op zijn beurt hoeft te wachten.
-
Om de prestaties snel en betrouwbaar te houden. Door de totale stroom van aanvragen te beheren, kunnen we snelle responstijden en een stabiele service voor al onze geweldige gebruikers behouden. Het is alsof je ervoor zorgt dat een snelweg niet te druk wordt: het verkeer stroomt beter wanneer we opstoppingen voorkomen!
Hoe limieten werken
Rate limits worden op 2 manieren gemeten:
- aanvragen per seconde: Dit is het aantal netwerkaanvragen dat je per seconde kunt doen.
- wachtrijtaken: Dit is het aantal gelijktijdige generatietaken dat je op elk willekeurig moment in de wachtrij kunt uitvoeren.
Wachtrijtaken omvatten de endpoints Tekst naar 3D, Afbeelding naar 3D, Tekst naar textuur en Remesh. Andere endpoints zoals Upload en Saldo vallen niet onder deze limiet.
De limieten worden per account toegepast. Dit betekent dat de limieten worden gedeeld door al je API keys.
Naast rate limits beïnvloedt de verwerkingsprioriteit van taken ook de snelheid van je taken.
Elk gebruikersniveau heeft specifieke rate limits en prioriteitsniveaus die zijn ontworpen om aan hun behoeften te voldoen. Dit zijn de huidige limieten per niveau:
| Gebruikersniveau | aanvragen per seconde | wachtrijtaken | Prioriteitsniveau |
|---|---|---|---|
| Pro | 20 | 10 | Standaard |
| Premium | 20 | 30 | Hoger dan Pro |
| Ultra | 20 | 100 | Hoogste |
| Studio | 20 | 20 | Hoger dan Pro |
| Enterprise | 100 | Standaard 50, kan worden aangepast | Hoogste |
Als je deze limieten overschrijdt, ontvang je een 429 Too Many Requests-respons van onze API. Er zijn twee soorten hits die dit kunnen activeren, elk met een andere respons:
- Aanvraaghit: Dit gebeurt wanneer je te veel aanvragen per seconde doet. Je ontvangt een
429 Too Many Requests-respons met eenRateLimitExceeded-bericht. - Wachtrijhit: Dit gebeurt wanneer je te veel gelijktijdige generatietaken hebt draaien. Je ontvangt een
429 Too Many Requests-respons met eenNoMoreConcurrentTasks-bericht.