Hastighetsgränser
Hastighetsgränser är restriktioner som vår API inför på antalet gånger en användare eller klient kan få tillgång till våra tjänster inom en angiven tidsperiod.
Varför gränser
Vi har infört hastighetsgränser på vår API för att skapa den bästa upplevelsen för alla. Här är varför de är viktiga:
-
För att hålla vår tjänst säker och sund! Tänk på hastighetsgränser som vänliga dörrvakter - de ser till att ingen kan överväldiga vår API med för många begäranden på en gång. Detta hjälper till att skydda vår tjänst från potentiellt missbruk och håller allt igång smidigt.
-
För att se till att alla får sin rättvisa andel. Precis som att dela leksaker på en lekplats vill vi se till att alla våra användare har lika tillgång till API:et. Genom att försiktigt begränsa hur många begäranden varje användare kan göra, säkerställer vi att ingen behöver vänta för länge på sin tur.
-
För att hålla prestandan snabb och pålitlig. Genom att hantera det övergripande flödet av begäranden kan vi upprätthålla snabba svarstider och stabil service för alla våra fantastiska användare. Det är som att se till att en motorväg inte blir för trång - trafiken flyter bättre när vi förhindrar trängsel!
Hur gränser fungerar
Hastighetsgränser mäts på 2 sätt:
- Begäranden per sekund: Detta är antalet nätverksbegäranden du kan göra per sekund.
- Köuppgifter: Detta är antalet samtidiga genereringsuppgifter du kan köra i kö vid varje given tidpunkt.
Köuppgifter inkluderar Text till 3D, Bild till 3D, Text till textur och Remesh endpoints. Andra endpoints som Uppladdning och Saldo ingår inte i denna gräns.
Gränserna tillämpas per konto. Detta innebär att gränserna delas över alla dina API keys.
Förutom hastighetsgränser kommer även uppgiftsbehandlingsprioritet att påverka hastigheten på dina uppgifter.
Varje användarnivå har specifika hastighetsgränser och prioritetsnivåer utformade för att matcha deras behov. Här är de nuvarande gränserna per nivå:
| Användarnivå | Begäranden per sekund | Köuppgifter | Prioritetsnivå |
|---|---|---|---|
| Pro | 20 | 10 | Standard |
| Premium | 20 | 30 | Högre än Pro |
| Ultra | 20 | 100 | Högst |
| Studio | 20 | 20 | Högre än Pro |
| Enterprise | 100 | Standard till 50, kan anpassas | Högst |
Om du överskrider dessa gränser kommer du att få ett 429 Too Many Requests svar från vår API. Det finns två typer av träffar som kan utlösa detta, var och en med ett annat svar:
- Begärandeträff: Detta händer när du gör för många begäranden per sekund. Du kommer att få ett
429 Too Many Requestssvar med ettRateLimitExceededmeddelande. - Köträff: Detta händer när du har för många samtidiga genereringsuppgifter igång. Du kommer att få ett
429 Too Many Requestssvar med ettNoMoreConcurrentTasksmeddelande.