Limity frekvence požadavků

Limity frekvence požadavků jsou omezení, která naše API ukládá na počet případů, kdy může uživatel nebo klient přistupovat k našim službám během stanoveného časového období.

Proč limity

V našem API jsme zavedli limity frekvence požadavků, abychom pomohli vytvořit co nejlepší prostředí pro všechny. Proto jsou důležité:

Aby naše služba zůstala bezpečná a v pořádku! Představte si limity frekvence požadavků jako přátelské vyhazovače – zajišťují, aby nikdo nemohl zahltit naše API příliš mnoha požadavky najednou. Pomáhá to chránit naši službu před možným zneužitím a udržuje vše v hladkém chodu.
Aby každý dostal svůj spravedlivý podíl. Stejně jako při sdílení hraček na hřišti chceme zajistit, aby všichni naši uživatelé měli k API rovný přístup. Tím, že jemně omezíme, kolik požadavků může každý uživatel provést, zajistíme, že nikdo nebude muset čekat příliš dlouho, než na něj přijde řada.
Aby výkon zůstal svižný a spolehlivý. Řízením celkového toku požadavků můžeme udržovat rychlé časy odezvy a stabilní službu pro všechny naše skvělé uživatele. Je to jako zajistit, aby se dálnice příliš nezaplnila – provoz plyne lépe, když předcházíme zácpám!

Jak limity fungují

Limity frekvence požadavků se měří 2 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 úloh generování, které můžete mít spuštěné ve frontě v libovolném okamžiku.

Úlohy ve frontě zahrnují endpointy Text na 3D, Obrázek na 3D, Text na texturu a Remesh. Jiné endpointy, například Upload a zůstatek, do tohoto limitu zahrnuty nejsou.

Limity se uplatňují pro každý účet samostatně. To znamená, že limity jsou sdílené napříč všemi vašimi API key.

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

Každá úroveň uživatele má konkrétní limity frekvence 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í je 50, lze přizpůsobit	Nejvyšší

Pokud tyto limity překročíte, obdržíte z 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 tomu 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 tomu dochází, když máte spuštěno příliš mnoho souběžných úloh generování. Obdržíte odpověď 429 Too Many Requests se zprávou NoMoreConcurrentTasks.