Limity požadavků

Limity požadavků jsou omezení, která naše API ukládá na počet přístupů uživatele nebo klienta k našim službám za stanovené časové období.

Proč limity

Zavedli jsme limity požadavků na naše API, abychom pro všechny vytvořili co nejlepší zážitek. Zde jsou důvody, proč jsou důležité:

Aby byla naše služba v bezpečí a v pořádku! Představte si limity požadavků jako přátelské vyhazovače - zajišťují, aby nikdo nemohl přetížit naše API příliš velkým množstvím požadavků najednou. To pomáhá chránit naši službu před potenciálním zneužitím a udržuje vše v hladkém chodu.
Aby se zajistilo, že každý dostane svůj spravedlivý díl. Stejně jako sdílení hraček na hřišti chceme zajistit, aby všichni naši uživatelé měli rovný přístup k API. Jemným omezením počtu požadavků, které může každý uživatel provést, zajišťujeme, že nikdo nemusí příliš dlouho čekat na svou řadu.
Aby výkon zůstal svižný a spolehlivý. Řízením celkového toku požadavků můžeme udržovat rychlé doby odezvy a stabilní službu pro všechny naše skvělé uživatele. Je to jako zajistit, aby dálnice nebyla příliš přetížená - provoz plyne lépe, když zabráníme přetížení!

Jak limity fungují

Limity požadavků se měří dvěma způsoby:

Požadavky za sekundu: Toto je počet síťových požadavků, které můžete provést za sekundu.
úlohy ve frontě: Toto je počet souběžných generovacích úloh, které můžete mít spuštěné ve frontě v daném okamžiku.

Mezi úlohy ve frontě patří endpointy Text na 3D, Obrázek na 3D, Text na texturu a Remesh. Ostatní endpointy, jako Upload a Balance, nejsou do tohoto limitu zahrnuty.

Limity jsou uplatňovány na úrovni jednotlivých účtů. To znamená, že limity jsou sdílené napříč všemi vašimi API klíči.

Kromě limitů požadavků ovlivňuje rychlost zpracování vašich úloh také priorita zpracování úloh.

Každá úroveň uživatele má specifické limity požadavků a úrovně priority navržené tak, aby odpovídaly jejím potřebám. Zde jsou aktuální limity podle úrovně:

Úroveň uživatele	Požadavky za sekundu	úlohy ve frontě	Úroveň priority
Pro	20	10	Výchozí
Premium	20	30	Vyšší než Pro
Ultra	20	100	Nejvyšší
Studio	20	20	Vyšší než Pro
Enterprise	100	Výchozí 100, lze přizpůsobit	Nejvyšší

Pokud tyto limity překročíte, obdržíte od našeho API odpověď 429 Too Many Requests. Existují dva typy zásahů, které to mohou vyvolat, každý s jinou odpovědí:

Zásah požadavku: K tomuto dochází, když provedete příliš mnoho požadavků za sekundu. Obdržíte odpověď 429 Too Many Requests se zprávou RateLimitExceeded.
Zásah fronty: K tomuto dochází, když máte spuštěno příliš mnoho souběžných generovacích úloh. Obdržíte odpověď 429 Too Many Requests se zprávou NoMoreConcurrentTasks.