Hastighetsgränser

Hastighetsgränser är begränsningar som vårt API tillämpar på antalet 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 hastighetsgränser i vårt API för att hjälpa till 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 vakter - de ser till att ingen kan överbelasta vårt 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 säkerställa 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 ser vi till 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 tjänst för alla våra fantastiska användare. Det är som att se till att en motorväg inte blir för överfull - 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 en given tidpunkt.

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

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

Förutom hastighetsgränser påverkar även prioritetsnivån för uppgiftshantering 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ögsta
Studio	20	20	Högre än Pro
Enterprise	100	Standard 100, kan anpassas	Högsta

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.