Limity rychlosti

Limity rychlosti jsou omezení, která naše API ukládá na počet přístupů uživatele nebo klienta k našim službám během určitého časového období.

Proč limity

Zavedli jsme limity rychlosti u našeho API, abychom pro všechny vytvořili co nejlepší zážitek. Zde je důvod, proč jsou důležité:

Aby naše služba zůstala bezpečná a stabilní! Představte si limity rychlosti jako přátelské vyhazovače - zajišťují, že nikdo nemůže naše API zahltit příliš mnoha požadavky najednou. To pomáhá chránit naši službu před případným zneužitím a udržuje vše v hladkém chodu.
Aby měl každý svůj spravedlivý díl. Stejně jako při 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 odeslat, zajišťujeme, že nikdo nemusí čekat na svou řadu příliš dlouho.
Aby výkon zůstal svižný a spolehlivý. Řízením celkového toku požadavků můžeme udržet rychlé 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ž zabráníme přetížení!

Jak limity fungují

Limity rychlosti se měří dvěma způsoby:

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

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

Limity se uplatňují na úrovni jednotlivého účtu. To znamená, že limity jsou sdíleny napříč všemi vašimi API klíči.

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

Každá úroveň uživatele má specifické limity rychlosti 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 tomu dochází, když odešlete příliš mnoho požadavků za sekundu. Obdržíte odpověď 429 Too Many Requests se zprávou Rate limit exceeded.
Zásah fronty: K tomu 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 NoMorePendingTasks (nebo, když vám dojdou kredity, NoMoreConcurrentTasks). Tato odpověď 429 nemá Retry-After: počkejte, až se dokončí jedna z vašich úloh, než vytvoříte další.

Hlavičky limitu rychlosti

Odpovědi API obsahují tyto hlavičky, abyste mohli tempo svých požadavků přizpůsobit:

Hlavička	Popis
`X-RateLimit-Limit`	Počet požadavků povolených za sekundu na vaší úrovni.
`X-RateLimit-Remaining`	Počet požadavků zbývajících v aktuální sekundě.
`X-RateLimit-Reset`	Počet sekund, než se váš rozpočet znovu naplní.
`Retry-After`	Počet sekund, které je třeba počkat před dalším požadavkem. Odesíláno při zásahu požadavku s odpovědí `429` a při načtení úlohy, která je stále ve stavu `PENDING` nebo `IN_PROGRESS`.

Pokud je hlavička Retry-After přítomna, počkejte uvedený počet sekund, než odešlete další požadavek.