Limity rychlosti

Zjistěte, kolik požadavků a úkolů váš plán umožňuje a co dělat, když dosáhnete limitu.

Limity podle plánu

Aby bylo API pro všechny rychlé a dostupné, Meshy omezuje každý účet dvěma způsoby:

Požadavky za sekundu: kolik API požadavků můžete odeslat každou sekundu.
Souběžné úkoly: kolik vašich úkolů může být zároveň ve stavu PENDING nebo IN_PROGRESS.

Limity závisí na vašem plánu:

Plán	Požadavky za sekundu	Souběžné úkoly	Priorita
Pro	20	10	Výchozí
Premium	20	30	Vyšší než Pro
Ultra	20	100	Nejvyšší
Studio	20	60, nebo 20 u některých starších plánů Studio	Vyšší než Pro
Enterprise	100	100 ve výchozím nastavení, nebo vlastní limit	Nejvyšší

Priorita není limit. Když je fronta vytížená, Meshy spouští nejprve úkoly s vyšší prioritou.

Co se počítá do jednotlivých limitů

Do limitu požadavků za sekundu se počítá každý API požadavek, včetně požadavků, které získávají, vypisují nebo streamují úkoly. Požadavky z webové aplikace Meshy se nepočítají.

Limit souběžných úkolů počítá úkoly, nikoli požadavky. Každý koncový bod, který vytváří úkol, tento limit kontroluje ještě před jeho vytvořením. Kontrolují ho například Text na 3D, Obrázek na 3D, Více obrázků na 3D, Retexturování, Remesh, Rigging, Animace, Text na obrázek, koncové body pro 3D tisk a Creative Lab.

Požadavky, které nevytvářejí úkol, se do něj nepočítají. Například Balance, Usage a požadavky, které získávají, vypisují nebo streamují úkoly, se nepočítají.

Čí limity platí

Následující tabulka ukazuje, čí limity se počítají pro vaše API klíče, Playground a webovou aplikaci:

Kde pracujete	Osobní účet	Tým
API klíče	Vaše limity	Limity týmu, sdílené všemi API klíči v týmu
Playground	Vaše limity	Vaše vlastní limity jako přihlášeného člena
Webová aplikace	Vaše souběžné úkoly	Vaše vlastní souběžné úkoly. Úkoly, které spustí vlastník týmu, se počítají i do limitů týmu.

Když dosáhnete limitu

Když překročíte limit, API vrátí 429 Too Many Requests. Zpráva vám sdělí, jakého limitu jste dosáhli:

Příliš mnoho požadavků za sekundu: zpráva zní Rate limit exceeded. Počkejte počet sekund uvedený v hlavičce Retry-After a poté to zkuste znovu.
Příliš mnoho souběžných úkolů: zpráva začíná textem NoMorePendingTasks. U neomezeného plánu bez zbývajících kreditů začíná textem NoMoreConcurrentTasks. Tato odpověď 429 neobsahuje hlavičku Retry-After. Počkejte, až se dokončí jeden z vašich úkolů, a teprve pak vytvořte další.

Hlavičky limitu rychlosti

Odpovědi API obsahují tyto hlavičky, které vám pomohou tempovat vaše požadavky:

Hlavička	Popis
`X-RateLimit-Limit`	Počet požadavků povolených za sekundu ve vašem plánu.
`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 opět naplní.
`Retry-After`	Počet sekund, které je třeba počkat před dalším požadavkem. Odesílá se s odpovědí `429` při příliš mnoha požadavcích za sekundu a také když získáte úkol, 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.