Frekvensgränser

Frekvensgränser är begränsningar som vårt API inför för hur många gånger en användare eller klient kan komma åt våra tjänster inom en angiven tidsperiod.

Varför gränser

Vi har infört frekvensgränser i vårt 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 stabil! Tänk på frekvensgränser som vänliga dörrvakter – de ser till att ingen kan överbelasta vårt API med för många begäranden samtidigt. 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 del. Precis som när man delar leksaker på en lekplats vill vi se till att alla våra användare har lika åtkomst till API:et. Genom att försiktigt begränsa hur många begäranden varje användare kan göra ser vi till att ingen behöver vänta för länge på sin tur.
För att hålla prestandan snabb och tillförlitlig. Genom att hantera det övergripande flödet av begäranden kan vi upprätthålla snabba svarstider och en stabil tjänst för alla våra fantastiska användare. Det är som att se till att en motorväg inte blir för full – trafiken flyter bättre när vi förhindrar trängsel!

Hur gränser fungerar

Frekvensgrä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ön vid en given tidpunkt.

Köuppgifter inkluderar endpointar för Text till 3D, Bild till 3D, Text till textur och Remesh. Andra endpointar som Upload och saldo ingår inte i denna gräns.

Gränserna tillämpas per konto. Det innebär att gränserna delas mellan alla dina API keys.

Utöver frekvensgränser påverkar även uppgiftens bearbetningsprioritet hastigheten för dina uppgifter.

Varje användarnivå har specifika frekvensgränser och prioritetsnivåer som är utformade för att matcha deras behov. Här är de aktuella 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 är 50, kan anpassas	Högst

Om du överskrider dessa gränser får du ett 429 Too Many Requests-svar från vårt 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 får ett 429 Too Many Requests-svar med ett RateLimitExceeded-meddelande.
Köträff: Detta händer när du har för många samtidiga genereringsuppgifter igång. Du får ett 429 Too Many Requests-svar med ett NoMoreConcurrentTasks-meddelande.