Ž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.
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í.PENDINGIN_PROGRESSSUCCEEDEDFAILEDTask 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.
| Stav | Co by měl váš kód dělat |
|---|---|
PENDING | Pokračovat v čekání. |
IN_PROGRESS | Sledovat progress: procento hotové práce, od 0 do 100. |
SUCCEEDED | Stáhnout výsledek. Meshy uchovává soubory po omezenou dobu. Viz Uchování assetů. |
FAILED | Přečíst task_error, poté opravit vstup nebo vytvořit nový task. Viz Chyby. |
CANCELED | Př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:
Požadavek: POST/image-to-3d
Odpověď: 202{ "result": "<task_id>" }task vytvořen
- Opakovat každých pár sekund
Požadavek: GET/image-to-3d/<task_id>
Odpověď: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5
Požadavek: GET/image-to-3d/<task_id>
Odpověď: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }
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í.
Jedná se o typické doby, nikoli zaručené doby dokončení. Během vytížených period mohou některé tasky trvat déle a přesto uspějí. Stav Meshy zkontrolujete na stránce stavu. Nepoužívejte tyto doby jako timeouty ve svém kódu. Hodnoty timeoutů najdete v části Jak dlouho čekat.
Generování 3D
| API | Konfigurace | meshy-7.1 (latest) | meshy-6 | meshy-6-lite | meshy-t2 |
|---|---|---|---|---|---|
| Text na 3D (Preview) | Pouze síť | 75 s | 90 s | 45 s | 10 s |
| Obrázek na 3D | Pouze síť | 75 s | 90 s | 40 s | 4 s |
| Síť s 2K texturami | 2 min | 3 min | 75 s | 60 s | |
| Síť s 4K texturami | 2,5 min | 3,5 min | Nepodporováno | 80 s | |
| Síť s 8K texturami | 3,5 min | 4 min | Nepodporováno | 2,5 min | |
| Více obrázků na 3D | Pouze síť | 65 s | 2 min | 30 s | Nepodporováno |
| Síť s 2K texturami | 2,5 min | 3,5 min | 85 s | Nepodporováno | |
| Síť s 4K texturami | 3 min | 4 min | Nepodporováno | Nepodporováno | |
| Síť s 8K texturami | 3,5 min | 4,5 min | Nepodporováno | Nepodporová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í
| API | Rozlišení textury | Typická doba |
|---|---|---|
| Text na 3D (Refine) | 2K nebo 4K | 80 s |
| 8K | 3,5 min | |
| Retexturování | 2K | 55 s |
| 4K | 90 s | |
| 8K | 2,5 min |
Generování obrázků
| API | nano-banana | nano-banana-2 | nano-banana-pro | Modely GPT Image |
|---|---|---|---|---|
| Text na obrázek | 20 s | 15 s | 25 s | 20 až 35 s |
| Obrázek na obrázek | 40 s | 20 s | 30 s | 20 až 40 s |
Rigging a animace
| API | Konfigurace | Typická doba |
|---|---|---|
| Auto-Rigging | Automatický rigging | 40 s |
| Animace | Na požadavek | 15 s |
| Text na pohyb | mode prime | 15 s |
mode swift | 10 s |
Následné zpracování
| API | Typická doba |
|---|---|
| Remesh | 2 min |
| UV rozbalení | 35 s |
| Převést | 7 s |
| Změnit velikost | 15 s |
3D tisk
| API | Konfigurace | Typická doba |
|---|---|---|
| Analyzovat tisknutelnost | Pouze kontroly sítě | 1 s |
| Kontroly sítě a tenkých stěn | 10 s | |
| Multi-Color | Na požadavek | 30 s |
| Opravit tisknutelnost | Pouze oprava sítě | 10 s |
| Kontrola tenkých stěn, stěny zachovány | 20 s | |
| Kontrola tenkých stěn, stěny zesíleny | 100 s | |
| Auto Split | Jednobarevné díly | 70 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_attasku, 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
FAILEDznamená, ž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 MB | 120 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 task | Alespoň 60 minut od created_at. Při opětovném připojení streamu toto počítání nerestartujte. |
| Stream | Stream 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.