Ireretiro ang lowpoly sa Oct 30, 2026. Ireretiro ang meshy-7 bilang 3D generation model sa Dec 31, 2026; mananatili itong available bilang texture model. Lumipat ng modelo bago ang mga petsang ito para maiwasan ang mga error sa request. Tingnan ang lahat ng deprecation

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.

Ang isang create request ay nagsisimula ng task sa 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.
Create request
PENDING
Naghihintay sa pila
IN_PROGRESS
Ginagawa ang resulta
SUCCEEDED
I-download ang resulta
FAILED
Na-refund ang credits

Itinatala 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.

StatusAno ang dapat gawin ng iyong code
PENDINGMagpatuloy sa paghihintay.
IN_PROGRESSSubaybayan ang progress: ang porsyento ng gawaing nagawa na, mula 0 hanggang 100.
SUCCEEDEDI-download ang resulta. Pinapanatili ni Meshy ang mga file sa loob ng limitadong panahon. Tingnan ang Asset retention.
FAILEDBasahin ang task_error, pagkatapos ay ayusin ang input o gumawa ng bagong task. Tingnan ang Errors.
CANCELEDItigil 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:

Gumawa ng task, pagkatapos ay i-poll ito hanggang matapos.
  1. Request: POST/image-to-3d

  2. Response: 202{ "result": "<task_id>" }nagawa na ang task

  3. Ulitin tuwing ilang segundo
    1. Request: GET/image-to-3d/<task_id>

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

  4. Request: GET/image-to-3d/<task_id>

  5. Response: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

Kung huminto ang iyong app sa paghihintay, patuloy pa ring tumatakbo ang task. I-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.

3D generation

APIConfigurationmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Text to 3D (Preview)Mesh lamang75 s90 s45 s10 s
Image to 3DMesh lamang75 s90 s40 s4 s
Mesh na may 2K textures2 min3 min75 s60 s
Mesh na may 4K textures2.5 min3.5 minHindi suportado80 s
Mesh na may 8K textures3.5 min4 minHindi suportado2.5 min
Multi-Image to 3DMesh lamang65 s2 min30 sHindi suportado
Mesh na may 2K textures2.5 min3.5 min85 sHindi suportado
Mesh na may 4K textures3 min4 minHindi suportadoHindi suportado
Mesh na may 8K textures3.5 min4.5 minHindi suportadoHindi 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

APITexture resolutionKaraniwang oras
Text to 3D (Refine)2K o 4K80 s
8K3.5 min
Retexture2K55 s
4K90 s
8K2.5 min

Image generation

APInano-banananano-banana-2nano-banana-proGPT Image models
Text to Image20 s15 s25 s20 hanggang 35 s
Image to Image40 s20 s30 s20 hanggang 40 s

Rigging at Animation

APIConfigurationKaraniwang oras
Auto-RiggingAwtomatikong rigging40 s
AnimationBawat request15 s
Text to Motionprime mode15 s
swift mode10 s

Post-processing

APIKaraniwang oras
Remesh2 min
UV Unwrap35 s
Convert7 s
Resize15 s

3D printing

APIConfigurationKaraniwang oras
Analyze PrintabilityMesh checks lamang1 s
Mesh at thin-wall checks10 s
Multi-ColorBawat request30 s
Repair PrintabilityMesh repair lamang10 s
Thin-wall check, napanatili ang mga pader20 s
Thin-wall check, pinalapot ang mga pader100 s
Auto SplitMga bahaging may kulay na patag70 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_at ng 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 FAILED lamang ang nangangahulugang nabigo ang task. Awtomatikong nire-refund ni Meshy ang mga nabigong task.

Gamitin ang mga halagang ito sa iyong code:

SettingInirerekomendang halaga
Timeout ng create request (POST)60 segundo
Timeout ng create request (POST) na may model_url file na higit sa 100 MB120 segundo. Dina-download ni Meshy ang file bago ito sumagot.
Timeout ng status request (GET)30 segundo
Poll intervalAng 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 taskHindi bababa sa 60 minuto mula sa created_at. Huwag i-restart ang bilang na ito kapag muli kang kumonekta sa isang stream.
StreamMaaaring 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.