Přejít na hlavní obsah

Jak opravit chyby Meshy API 429 a omezení rychlosti

Omezení rychlosti Meshy API: Oprava chyb 429

Obsah

Pokud vaše integrace při volání Meshy API naráží na chyby 429, RateLimitExceeded nebo NoMoreConcurrentTasks, tento průvodce vysvětluje, proč tato omezení existují a jak navrhnout integraci tak, aby v jejich rámci fungovala.

Proč existují omezení rychlosti

Meshy API využívá sdílenou výpočetní kapacitu GPU, která slouží ke generování 3D modelů, textur a souvisejících assetů. Omezení rychlosti a maximální počty současně běžících úloh chrání tuto sdílenou infrastrukturu, aby kvalita generování a doba zpracování zůstaly konzistentní pro každého uživatele platformy. Každý účet má na základě svého aktuálního plánu maximální počet požadavků, které může provést v daném časovém okně, a maximální počet úloh generování, které může mít současně spuštěných (ve frontě nebo probíhajících).

Limit požadavků vs. limit fronty/současnosti

Existují dva odlišné limity a každý selhává jinak:

  • Limit rychlosti požadavků (429 / RateLimitExceeded): omezuje, kolik volání API (např. vytvoření úlohy, dotazování na stav) můžete provést za minutu. Jeho překročení znamená, že voláte API příliš často, bez ohledu na to, kolik úloh skutečně běží.

  • Limit současnosti / fronty (NoMoreConcurrentTasks): omezuje, kolik úloh generování můžete mít současně ve frontě nebo ve zpracování. Jeho překročení znamená, že již máte maximální počet aktivních úloh a před odesláním další musíte počkat, až jedna skončí.

Aktuální limity požadavků a současnosti svého plánu zkontrolujte ve svém dashboardu Meshy, protože se mohou lišit podle úrovně plánu.

Strategie backoff pro chyby 429

Když obdržíte odpověď 429 nebo RateLimitExceeded, neopakujte stejný požadavek okamžitě. Místo toho:

  • Použijte exponenciální backoff: počkejte krátký interval a při každém dalším selhání jej zdvojnásobte až do rozumného maxima.

  • Přidejte jitter (malý náhodný posun) k intervalu backoffu, aby všechny pracovní procesy ve vašem systému neopakovaly požadavek ve stejný okamžik.

  • Respektujte případné hlavičky Retry-After nebo hlavičky s limity rychlosti vrácené v odpovědi, pokud jsou přítomny, místo odhadování doby čekání.

  • Omezte počet opakovaných pokusů na požadavek, aby přetrvávající selhání nevedlo k nekonečnému cyklu.

Plánování s ohledem na limity současnosti

Chyba NoMoreConcurrentTasks znamená, že jste již na stropu aktivních úloh svého účtu. Abyste se tomu v produkci vyhnuli:

  • Ve své vlastní aplikaci udržujte lokální frontu nebo plánovač úloh, který odešle novou úlohu generování až poté, co se předchozí dokončí nebo váš počet aktivních úloh klesne pod limit.

  • Sledujte stav úlohy dotazováním (nebo používejte webhooky, pokud je váš pracovní postup podporuje), abyste věděli, kdy se uvolní slot, místo abyste odesílali požadavky naslepo.

  • Dávkujte a omezujte hromadné úlohy generování místo odesílání všech požadavků najednou — vyhladí to jak rychlost vašich požadavků, tak počet souběžných úloh.

  • Zaveďte na své straně monitorování/upozorňování, aby byl nárůst chyb 429/NoMoreConcurrentTasks viditelný dříve, než ovlivní vaše uživatele.

Opakování neúspěšných nebo nevyhovujících generování

Meshy API v současnosti nepodporuje vestavěné opakování („retry“) existujícího generování pro plány Individual ani Studio – pokud výsledek neodpovídá vašim očekáváním, odešlete nový požadavek na generování, který jako obvykle spotřebuje kredity. Když váš automatizovaný pipeline zpracovává přechodné chyby (například 429), ujistěte se, že vaše logika opakování znovu odesílá pouze původní požadavek po backoffu a při každém pokusu nevytváří duplicitní úlohy generování.

Kdy zvážit upgrade plánu

Pokud jste implementovali backoff a frontu zohledňující limity současnosti a přesto stále pravidelně narážíte na limity rychlosti nebo současnosti, obvykle to znamená, že potřeby propustnosti vaší integrace přerostly limity vašeho aktuálního plánu. Zkontrolujte ve svém dashboardu limity požadavků a současnosti pro aktuální plán a zvažte upgrade, případně kontaktujte obchodní tým Meshy ohledně přístupu k API na podnikové úrovni, pokud potřebujete trvale vyšší propustnost.

FAQ

1. Co znamená chyba 429 nebo RateLimitExceeded?

Znamená to, že jste překročili počet požadavků API povolených v daném časovém okně pro váš plán. Před dalším pokusem snižte rychlost požadavků a použijte exponenciální backoff.

2. Co znamená NoMoreConcurrentTasks?

Znamená to, že pro váš účet již je zařazen nebo probíhá maximální počet úloh generování. Před odesláním dalších počkejte, až některá stávající úloha dokončí, nebo snižte počet úloh, které odesíláte najednou.

3. Jak zjistím limity rychlosti a současnosti mého účtu?

Limity spojené s vaším aktuálním plánem najdete ve svém dashboardu Meshy, protože se mohou mezi jednotlivými úrovněmi plánů lišit.

4. Podporuje Meshy automatické opakované pokusy pro úlohy generování?

Ne, u individuálních plánů ani plánů Studio ne — neúspěšné nebo nevyhovující generování je nutné odeslat znovu jako nový požadavek, což běžně spotřebovává kredity. Zákazníci s plánem Enterprise by se měli ohledně funkcionality opakovaných pokusů obrátit na obchodní oddělení.

5. Jak se nejlépe vyhnout těmto chybám v produkčním pipeline?

Implementujte lokální frontu, která omezuje odesílání požadavků tak, aby zůstalo pod vaším limitem současnosti, přidejte exponenciální backoff s jitterem pro všechny odpovědi 429 a sledujte míru chyb, abyste mohli reagovat dříve, než ovlivní vaše uživatele.

6. Kdy bych měl kvůli omezením rychlosti upgradovat plán?

Pokud jste již implementovali backoff a frontu respektující současnost a přesto pravidelně narážíte na tyto limity, váš objem využití pravděpodobně přerostl aktuální plán — zkontrolujte dashboard nebo se obraťte na obchodní oddělení ohledně plánu s vyšší propustností.


Související články

Odpověděl vám tento článek na otázku?