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 voor iedereen de best mogelijke ervaring te creëren. Hier is waarom ze belangrijk zijn:
-
Om onze dienst veilig en gezond te houden! Zie snelheidslimieten 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 zoals het delen van speelgoed 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 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 een stabiele dienst behouden voor al onze geweldige gebruikers. Het is alsof je ervoor zorgt dat een snelweg niet te druk wordt - het verkeer stroomt beter wanneer we congestie voorkomen!
Hoe limieten werken
Snelheidslimieten 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 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 Balance vallen niet onder deze limiet.
De limieten worden per account toegepast. Dit betekent dat de limieten worden gedeeld over al je API keys.
Naast snelheidslimieten heeft ook de verwerkingsprioriteit van taken invloed op de snelheid van je taken.
Elk gebruikersniveau heeft specifieke snelheidslimieten en prioriteitsniveaus die zijn afgestemd op de behoeften ervan. Hier 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 | Hoogst |
| Studio | 20 | 20 | Hoger dan Pro |
| Enterprise | 100 | Standaard 100, kan aangepast worden | Hoogst |
Als je deze limieten overschrijdt, ontvang je een 429 Too Many Requests-reactie van onze API. Er zijn twee soorten treffers die dit kunnen veroorzaken, elk met een andere reactie:
- Aanvraagtreffer: Dit gebeurt wanneer je te veel aanvragen per seconde doet. Je ontvangt een
429 Too Many Requests-reactie met eenRateLimitExceeded-melding. - Wachtrijtreffer: Dit gebeurt wanneer je te veel gelijktijdige generatietaken hebt lopen. Je ontvangt een
429 Too Many Requests-reactie met eenNoMoreConcurrentTasks-melding.