lowpoly bude vyřazen 30. 10. 2026. meshy-7 bude jako model pro generování 3D vyřazen 31. 12. 2026; jako texturovací model zůstává k dispozici. Před těmito daty přejděte na jiný model, abyste předešli chybám požadavků. Zobrazit všechna ukončení podpory

Životní cyklus tasku

Zjistěte, jak task postupuje od požadavku k výsledku, jak dlouho to obvykle trvá a jak dlouho by na něj měl váš kód čekat.


Jak task probíhá

Požadavek na vytvoření vrátí ID tasku, aniž by čekal na jeho dokončení. Task pak běží na pozadí a vy jej sledujete jedním ze tří způsobů: dotazováním (poll) jeho GET koncového bodu, otevřením jeho stream koncového bodu, nebo přijetím webhooku.

Požadavek na vytvoření spustí task ve stavu PENDING. Worker jej převezme a přejde do stavu IN_PROGRESS, kde stráví většinu času. Skončí ve stavu SUCCEEDED nebo FAILED, a finální stav se již nikdy nezmění.
Požadavek na vytvoření
PENDING
Čekání ve frontě
IN_PROGRESS
Generování výsledku
SUCCEEDED
Stáhnout výsledek
FAILED
Kredity vráceny

Task zaznamenává každý krok ve svých polích created_at, started_at a finished_at.

Následující tabulka ukazuje, co by měl váš kód dělat v jednotlivých stavech.

StavCo by měl váš kód dělat
PENDINGPokračovat v čekání.
IN_PROGRESSSledovat progress: procento hotové práce, od 0 do 100.
SUCCEEDEDStáhnout výsledek. Meshy uchovává soubory po omezenou dobu. Viz Uchování assetů.
FAILEDPřečíst task_error, poté opravit vstup nebo vytvořit nový task. Viz Chyby.
CANCELEDPřestat čekat. Task nevytvoří výsledek. Tento stav používají pouze tasky Creative Lab.

SUCCEEDED, FAILED a CANCELED jsou finální stavy. Jakmile task jednoho z nich dosáhne, jeho stav se již nikdy nezmění.

Z pohledu vašeho kódu to vypadá takto:

Vytvořte task a poté se na něj dotazujte (poll), dokud se nedokončí.
  1. Požadavek: POST/image-to-3d

  2. Odpověď: 202{ "result": "<task_id>" }task vytvořen

  3. Opakovat každých pár sekund
    1. Požadavek: GET/image-to-3d/<task_id>

    2. Odpověď: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5

  4. Požadavek: GET/image-to-3d/<task_id>

  5. Odpověď: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

Pokud vaše aplikace přestane čekat, task běží dál. Získejte jej (GET) později se stejným ID tasku.

Doby zpracování

Následující tabulky ukazují mediánové doby na produkčním API provozu v září 2026.

Doba běží od vytvoření tasku až po finální stav. Téměř celá doba je zpracování, protože task obvykle zůstává ve stavu PENDING jen pár sekund. Když je fronta vytížená, tasky mohou čekat na spuštění déle, a tasky na plánech s vyšší prioritou obvykle startují dříve.

Doby pod 2 minuty jsou v sekundách (s), delší doby v minutách (min). „Nepodporováno“ znamená, že API tuto možnost u daného modelu nenabízí.

Generování 3D

APIKonfiguracemeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Text na 3D (Preview)Pouze síť75 s90 s45 s10 s
Obrázek na 3DPouze síť75 s90 s40 s4 s
Síť s 2K texturami2 min3 min75 s60 s
Síť s 4K texturami2,5 min3,5 minNepodporováno80 s
Síť s 8K texturami3,5 min4 minNepodporováno2,5 min
Více obrázků na 3DPouze síť65 s2 min30 sNepodporováno
Síť s 2K texturami2,5 min3,5 min85 sNepodporováno
Síť s 4K texturami3 min4 minNepodporovánoNepodporováno
Síť s 8K texturami3,5 min4,5 minNepodporovánoNepodporováno

Pro Obrázek na 3D a Více obrázků na 3D znamená „Pouze síť“ should_texture: false. Tyto možnosti a vstupy mění dobu:

  • PBR mapy (enable_pbr) přidávají 30 až 60 sekund.
  • Ultra geometrie (geometry_resolution: "2k" nebo "4k") přidává až 1 minutu.
  • Při stejném nastavení trvá zpracování složitějších vstupních obrázků déle.

Texturování

APIRozlišení texturyTypická doba
Text na 3D (Refine)2K nebo 4K80 s
8K3,5 min
Retexturování2K55 s
4K90 s
8K2,5 min

Generování obrázků

APInano-banananano-banana-2nano-banana-proModely GPT Image
Text na obrázek20 s15 s25 s20 až 35 s
Obrázek na obrázek40 s20 s30 s20 až 40 s

Rigging a animace

APIKonfiguraceTypická doba
Auto-RiggingAutomatický rigging40 s
AnimaceNa požadavek15 s
Text na pohybmode prime15 s
mode swift10 s

Následné zpracování

APITypická doba
Remesh2 min
UV rozbalení35 s
Převést7 s
Změnit velikost15 s

3D tisk

APIKonfiguraceTypická doba
Analyzovat tisknutelnostPouze kontroly sítě1 s
Kontroly sítě a tenkých stěn10 s
Multi-ColorNa požadavek30 s
Opravit tisknutelnostPouze oprava sítě10 s
Kontrola tenkých stěn, stěny zachovány20 s
Kontrola tenkých stěn, stěny zesíleny100 s
Auto SplitJednobarevné díly70 s
Texturované díly (keep_texture: true)170 s

Ve verzi v2 vždy spouští Opravit tisknutelnost a Analyzovat tisknutelnost kontrolu tenkých stěn. Ve verzi v1 ji spouští, pokud odešlete typ tiskárny nebo velikost tisku.


Jak dlouho čekat

Task běží dál, i když váš kód přestane čekat. Pokud váš požadavek vyprší (timeout), spojení se přeruší nebo se stream uzavře, task tím neselže ani se nezruší.

  • Počkejte alespoň 60 minut počítaných od created_at tasku, než přestanete čekat. Pokud přestanete čekat dříve, můžete přijít o task, který později uspěje. To se děje hlavně během vytížených period.
  • Uchovejte si ID tasku. Task můžete znovu získat kdykoli. Pokud po 60 minutách stále není ve finálním stavu, zkontrolujte jej znovu později. Pokud to přetrvává, kontaktujte podporu.
  • Pouze FAILED znamená, že task selhal. Meshy u neúspěšných tasků automaticky vrací kredity.

Ve svém kódu použijte tyto hodnoty:

NastaveníDoporučená hodnota
Timeout požadavku na vytvoření (POST)60 sekund
Timeout požadavku na vytvoření (POST) se souborem model_url větším než 100 MB120 sekund. Meshy soubor stáhne ještě před odpovědí.
Timeout požadavku na stav (GET)30 sekund
Interval dotazováníHlavička Retry-After, nebo 5 sekund, pokud chybí. Dotazy (polly) se počítají do vašeho limitu rychlosti.
Neúspěšný požadavek na stav (timeout, 429 nebo 5xx)Zkuste to znovu při dalším dotazu. Neznamená to, že task selhal.
Celková doba čekání na taskAlespoň 60 minut od created_at. Při opětovném připojení streamu toto počítání nerestartujte.
StreamStream se může uzavřít dříve, než task skončí. Pokud se uzavře bez finálního stavu, znovu se připojte nebo přejděte na dotazování.

Pro velké množství tasků najednou používejte webhooky místo dotazování každého z nich zvlášť. Pokud finální událost tasku nedorazí ani po přibližně dvojnásobku jeho typické doby, získejte task z jeho GET koncového bodu.