Buhay-ikot ng task
Alamin kung paano gumagalaw ang isang task mula sa kahilingan patungo sa resulta, kung gaano ito katagal karaniwang tumatagal, at kung gaano katagal dapat maghintay ang iyong code para rito.
Paano tumatakbo ang isang task
Ang isang create request ay nagbabalik ng task ID nang hindi hinihintay na tumakbo ang task. Pagkatapos ay tumatakbo ang task sa background, at susundan mo ito sa isa sa tatlong paraan: i-poll ang GET endpoint nito, buksan ang stream endpoint nito, o tumanggap ng webhook.
PENDING. Ito ay kinukuha ng isang worker at lumilipat sa IN_PROGRESS, kung saan gumugugol ito ng karamihan ng oras nito. Natatapos ito sa SUCCEEDED o FAILED, at ang huling status ay hindi na nagbabago.PENDINGIN_PROGRESSSUCCEEDEDFAILEDItinatala ng task ang bawat hakbang sa mga field nitong created_at, started_at, at finished_at.
Ipinapakita ng sumusunod na talahanayan kung ano ang dapat gawin ng iyong code sa bawat status.
| Status | Ano ang dapat gawin ng iyong code |
|---|---|
PENDING | Magpatuloy sa paghihintay. |
IN_PROGRESS | Subaybayan ang progress: ang porsyento ng gawaing nagawa na, mula 0 hanggang 100. |
SUCCEEDED | I-download ang resulta. Pinapanatili ni Meshy ang mga file sa loob ng limitadong panahon. Tingnan ang Asset retention. |
FAILED | Basahin ang task_error, pagkatapos ay ayusin ang input o gumawa ng bagong task. Tingnan ang Errors. |
CANCELED | Itigil ang paghihintay. Hindi magbubunga ng resulta ang task. Mga Creative Lab task lamang ang gumagamit ng status na ito. |
Ang SUCCEEDED, FAILED, at CANCELED ay huli na. Kapag naabot na ng task ang isa sa mga ito, hindi na muling magbabago ang status nito.
Mula sa iyong code, ganito ang hitsura nito:
Request: POST/image-to-3d
Response: 202{ "result": "<task_id>" }nagawa na ang task
- Ulitin tuwing ilang segundo
Request: GET/image-to-3d/<task_id>
Response: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5
Request: GET/image-to-3d/<task_id>
Response: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }
GET ito mamaya gamit ang parehong task ID.Oras ng pagproseso
Ipinapakita ng mga sumusunod na talahanayan ang median na oras sa production API traffic noong Setyembre 2026.
Ang oras ay tumatakbo mula sa paggawa ng task hanggang sa huling status. Halos lahat nito ay pagproseso, dahil ang isang task ay karaniwang nananatili sa PENDING sa loob lamang ng ilang segundo. Kapag abala ang pila, maaaring mas matagal maghintay ang mga task bago magsimula, at ang mga task sa mga plano na may mas mataas na priority ay karaniwang nagsisimula nang mas maaga.
Ang mga oras na mas mababa sa 2 minuto ay nasa segundo (s), at ang mas matatagal na oras ay nasa minuto (min). Ang Hindi suportado ay nangangahulugang hindi inaalok ng API ang opsyong iyon sa modelong iyon.
Ito ay karaniwang oras, hindi garantisadong oras ng pagkumpleto. Sa mga abalang panahon, may mga task na mas matagal pero matagumpay pa rin. Para suriin ang status ng Meshy, tingnan ang status page. Huwag gamitin ang mga oras na ito bilang timeout sa iyong code. Para sa mga halaga ng timeout, tingnan ang Gaano katagal maghihintay.
3D generation
| API | Configuration | meshy-7.1 (latest) | meshy-6 | meshy-6-lite | meshy-t2 |
|---|---|---|---|---|---|
| Text to 3D (Preview) | Mesh lamang | 75 s | 90 s | 45 s | 10 s |
| Image to 3D | Mesh lamang | 75 s | 90 s | 40 s | 4 s |
| Mesh na may 2K textures | 2 min | 3 min | 75 s | 60 s | |
| Mesh na may 4K textures | 2.5 min | 3.5 min | Hindi suportado | 80 s | |
| Mesh na may 8K textures | 3.5 min | 4 min | Hindi suportado | 2.5 min | |
| Multi-Image to 3D | Mesh lamang | 65 s | 2 min | 30 s | Hindi suportado |
| Mesh na may 2K textures | 2.5 min | 3.5 min | 85 s | Hindi suportado | |
| Mesh na may 4K textures | 3 min | 4 min | Hindi suportado | Hindi suportado | |
| Mesh na may 8K textures | 3.5 min | 4.5 min | Hindi suportado | Hindi suportado |
Para sa Image to 3D at Multi-Image to 3D, ang "Mesh lamang" ay nangangahulugang should_texture: false. Ang mga opsyon at input na ito ay nagbabago ng oras:
- Ang PBR maps (
enable_pbr) ay nagdaragdag ng 30 hanggang 60 segundo. - Ang Ultra geometry (
geometry_resolution: "2k"o"4k") ay nagdaragdag ng hanggang 1 minuto. - Sa parehong mga setting, ang mas kumplikadong mga input image ay mas matagal.
Texturing
| API | Texture resolution | Karaniwang oras |
|---|---|---|
| Text to 3D (Refine) | 2K o 4K | 80 s |
| 8K | 3.5 min | |
| Retexture | 2K | 55 s |
| 4K | 90 s | |
| 8K | 2.5 min |
Image generation
| API | nano-banana | nano-banana-2 | nano-banana-pro | GPT Image models |
|---|---|---|---|---|
| Text to Image | 20 s | 15 s | 25 s | 20 hanggang 35 s |
| Image to Image | 40 s | 20 s | 30 s | 20 hanggang 40 s |
Rigging at Animation
| API | Configuration | Karaniwang oras |
|---|---|---|
| Auto-Rigging | Awtomatikong rigging | 40 s |
| Animation | Bawat request | 15 s |
| Text to Motion | prime mode | 15 s |
swift mode | 10 s |
Post-processing
3D printing
| API | Configuration | Karaniwang oras |
|---|---|---|
| Analyze Printability | Mesh checks lamang | 1 s |
| Mesh at thin-wall checks | 10 s | |
| Multi-Color | Bawat request | 30 s |
| Repair Printability | Mesh repair lamang | 10 s |
| Thin-wall check, napanatili ang mga pader | 20 s | |
| Thin-wall check, pinalapot ang mga pader | 100 s | |
| Auto Split | Mga bahaging may kulay na patag | 70 s |
Mga bahaging may texture (keep_texture: true) | 170 s |
Sa v2, ang Repair Printability at Analyze Printability ay palaging nagpapatakbo ng thin-wall check. Sa v1, pinapatakbo nila ito kapag nagpadala ka ng printer type o print size.
Gaano katagal maghihintay
Ang task ay patuloy na tumatakbo kahit huminto na ang iyong code sa paghihintay. Kung mag-timeout ang iyong request, mahulog ang iyong koneksyon, o magsara ang iyong stream, hindi nabibigo o na-cancel ang task.
- Maghintay nang hindi bababa sa 60 minuto, bilang mula sa
created_atng task, bago ka huminto sa paghihintay. Kung mas maagang huminto, maaari mong hindi mapansin ang task na matagumpay sa huli. Karaniwan itong nangyayari sa mga abalang panahon. - Itago ang task ID. Maaari mong kunin muli ang task anumang oras. Kung hindi pa rin ito huli matapos ang 60 minuto, suriin itong muli mamaya. Kung patuloy itong ganoon, makipag-ugnayan sa support.
- Ang
FAILEDlamang ang nangangahulugang nabigo ang task. Awtomatikong nire-refund ni Meshy ang mga nabigong task.
Gamitin ang mga halagang ito sa iyong code:
| Setting | Inirerekomendang halaga |
|---|---|
Timeout ng create request (POST) | 60 segundo |
Timeout ng create request (POST) na may model_url file na higit sa 100 MB | 120 segundo. Dina-download ni Meshy ang file bago ito sumagot. |
Timeout ng status request (GET) | 30 segundo |
| Poll interval | Ang Retry-After header, o 5 segundo kung ito ay wala. Ang mga poll ay binibilang sa iyong rate limit. |
Nabigong status request (timeout, 429, o 5xx) | Subukan muli sa susunod na poll. Hindi ito nangangahulugang nabigo ang task. |
| Kabuuang paghihintay bawat task | Hindi bababa sa 60 minuto mula sa created_at. Huwag i-restart ang bilang na ito kapag muli kang kumonekta sa isang stream. |
| Stream | Maaaring magsara ang isang stream bago matapos ang task. Kung magsara ito nang walang huling status, kumonekta ulit o lumipat sa polling. |
Para sa maraming task nang sabay-sabay, gamitin ang webhooks sa halip na i-poll ang bawat isa. Kung hindi pa dumating ang huling event ng isang task matapos ang humigit-kumulang dalawang beses ng karaniwang oras nito, kunin ang task mula sa GET endpoint nito.