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 sekundKöuppgifterPrioritetsnivå
Pro2010Standard
Premium2030Högre än Pro
Ultra20100Högst
Studio2020Högre än Pro
Enterprise100Standard till 50, kan anpassasHö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 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 kommer att få ett 429 Too Many Requests svar med ett NoMoreConcurrentTasks meddelande.