Limity rychlosti

Limity rychlosti jsou omezení, která naše API ukládá na počet, kolikrát může uživatel nebo klient přistupovat k našim službám za určité časové období.

---

Proč limity

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

• Abychom udrželi naši službu v bezpečí a pořádku! Představte si limity rychlosti jako přátelské vyhazovače – zajišťují, že nikdo nemůže zahltit naše API 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 chodu hladce.

• Abychom zajistili, ž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 odeslat, zajišťujeme, že nikdo nemusí čekat příliš dlouho na svou řadu.

• Abychom udrželi výkon svižný a spolehlivý. Správou celkového toku požadavků dokážeme udržet 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řeplněná – doprava proudí lépe, když předchází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 spuštěné ve frontě v daném okamžiku.

Úlohy ve frontě jsou úlohy na vašem účtu, které jsou ve stavu PENDING nebo IN_PROGRESS. Každý koncový bod, který vytváří úlohu (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), tento limit kontroluje před přijetím nové úlohy. Požadavky, které nevytvářejí úlohu, jako jsou Balance, Usage a získávání, výpis nebo streamování úloh, se do tohoto limitu nezapočítávají, i když se stále počítají do limitu požadavků za sekundu.

Limity se uplatňují na úrovni účtu, takže jsou sdíleny napříč všemi vašimi API klíči a Playground. Úlohy, které spustíte ve webové aplikaci Meshy, se také počítají do vašich úloh ve frontě.

Kromě limitů rychlosti ovlivní rychlost zpracování vašich úloh také priorita zpracování úloh.

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

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 spustit, každý s jinou odpovědí:

• Zásah požadavkem: Toto nastane, 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 frontou: Toto nastane, 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, pokud vám dojdou kredity, NoMoreConcurrentTasks). Tato 429 nemá Retry-After: počkejte, až jedna z vašich úloh skončí, 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:

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