lowpoly akan dihentikan pada 30 Okt 2026. meshy-7 sebagai model penjanaan 3D akan dihentikan pada 31 Dis 2026; sebagai model tekstur ia kekal tersedia. Tukar model sebelum tarikh-tarikh ini untuk mengelakkan ralat permintaan. Lihat semua penamatan

Kitaran hayat tugas

Ketahui bagaimana tugas bergerak dari permintaan ke hasil, berapa lama biasanya ia mengambil masa, dan berapa lama kod anda sepatutnya menunggunya.


Bagaimana tugas berjalan

Permintaan buat mengembalikan ID tugas tanpa menunggu tugas tersebut berjalan. Tugas kemudian berjalan di latar belakang, dan anda mengikutinya dengan salah satu daripada tiga cara: poll endpoint GET-nya, buka endpoint strimnya, atau terima webhook.

Permintaan buat memulakan tugas dalam PENDING. Pekerja mengambilnya dan ia beralih ke IN_PROGRESS, di mana ia menghabiskan sebahagian besar masanya. Ia berakhir dalam SUCCEEDED atau FAILED, dan status akhir tidak pernah berubah.
Permintaan buat
PENDING
Menunggu dalam baris gilir
IN_PROGRESS
Menjana hasil
SUCCEEDED
Muat turun hasil
FAILED
Kredit dikembalikan

Tugas merekodkan setiap langkah dalam medan created_at, started_at, dan finished_at.

Jadual berikut menunjukkan apa yang sepatutnya dilakukan oleh kod anda pada setiap status.

StatusApa yang sepatutnya dilakukan oleh kod anda
PENDINGTerus menunggu.
IN_PROGRESSJejaki progress: peratusan kerja yang telah selesai, dari 0 hingga 100.
SUCCEEDEDMuat turun hasil. Meshy menyimpan fail untuk tempoh masa yang terhad. Lihat Pengekalan aset.
FAILEDBaca task_error, kemudian betulkan input atau buat tugas baharu. Lihat Ralat.
CANCELEDBerhenti menunggu. Tugas tidak akan menghasilkan sebarang hasil. Hanya tugas Creative Lab yang menggunakan status ini.

SUCCEEDED, FAILED, dan CANCELED adalah muktamad. Selepas tugas mencapai salah satu daripadanya, statusnya tidak akan berubah lagi.

Dari sudut pandangan kod anda, ia kelihatan seperti ini:

Buat tugas, kemudian poll ia sehingga selesai.
  1. Permintaan: POST/image-to-3d

  2. Respons: 202{ "result": "<task_id>" }tugas dicipta

  3. Ulang setiap beberapa saat
    1. Permintaan: GET/image-to-3d/<task_id>

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

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

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

Jika aplikasi anda berhenti menunggu, tugas terus berjalan. GET ia kemudian dengan ID tugas yang sama.

Masa pemprosesan

Jadual berikut menunjukkan masa median pada trafik API produksi pada September 2026.

Masa dikira dari penciptaan tugas sehingga status akhir. Hampir kesemuanya adalah pemprosesan, kerana tugas biasanya kekal dalam PENDING hanya untuk beberapa saat. Apabila baris gilir sibuk, tugas boleh menunggu lebih lama sebelum ia bermula, dan tugas pada pelan dengan keutamaan yang lebih tinggi biasanya bermula lebih awal.

Masa di bawah 2 minit dinyatakan dalam saat (s), dan masa yang lebih lama dinyatakan dalam minit (min). Tidak disokong bermaksud API tidak menawarkan pilihan tersebut dengan model itu.

Penjanaan 3D

APIKonfigurasimeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Text to 3D (Preview)Jejaring sahaja75 s90 s45 s10 s
Imej ke 3DJejaring sahaja75 s90 s40 s4 s
Jejaring dengan tekstur 2K2 min3 min75 s60 s
Jejaring dengan tekstur 4K2.5 min3.5 minTidak disokong80 s
Jejaring dengan tekstur 8K3.5 min4 minTidak disokong2.5 min
Berbilang Imej ke 3DJejaring sahaja65 s2 min30 sTidak disokong
Jejaring dengan tekstur 2K2.5 min3.5 min85 sTidak disokong
Jejaring dengan tekstur 4K3 min4 minTidak disokongTidak disokong
Jejaring dengan tekstur 8K3.5 min4.5 minTidak disokongTidak disokong

Untuk Imej ke 3D dan Berbilang Imej ke 3D, "Jejaring sahaja" bermaksud should_texture: false. Pilihan dan input berikut mengubah masa:

  • Peta PBR (enable_pbr) menambah 30 hingga 60 saat.
  • Geometri ultra (geometry_resolution: "2k" atau "4k") menambah sehingga 1 minit.
  • Dengan tetapan yang sama, imej input yang lebih kompleks mengambil masa lebih lama.

Pengteksturan

APIResolusi teksturMasa biasa
Text to 3D (Refine)2K atau 4K80 s
8K3.5 min
Retekstur2K55 s
4K90 s
8K2.5 min

Penjanaan imej

APInano-banananano-banana-2nano-banana-proModel GPT Image
Teks ke Imej20 s15 s25 s20 hingga 35 s
Imej ke Imej40 s20 s30 s20 hingga 40 s

Rigging dan Animasi

APIKonfigurasiMasa biasa
Auto-RiggingRigging automatik40 s
AnimasiSetiap permintaan15 s
Text to Motionmode prime15 s
mode swift10 s

Pemprosesan pasca

APIMasa biasa
Remesh2 min
UV Unwrap35 s
Tukar7 s
Ubah saiz15 s

Pencetakan 3D

APIKonfigurasiMasa biasa
Analisis kebolehcetakanSemakan jejaring sahaja1 s
Semakan jejaring dan dinding nipis10 s
Multi-ColorSetiap permintaan30 s
Baiki kebolehcetakanBaik pulih jejaring sahaja10 s
Semakan dinding nipis, dinding dikekalkan20 s
Semakan dinding nipis, dinding ditebalkan100 s
Auto SplitBahagian berwarna rata70 s
Bahagian bertekstur (keep_texture: true)170 s

Pada v2, Baiki kebolehcetakan dan Analisis kebolehcetakan sentiasa menjalankan semakan dinding nipis. Pada v1, ia menjalankan semakan tersebut apabila anda menghantar jenis pencetak atau saiz cetakan.


Berapa lama untuk menunggu

Tugas terus berjalan walaupun kod anda berhenti menunggu. Jika permintaan anda timeout, sambungan anda terputus, atau strim anda ditutup, tugas tidak akan gagal dan tidak dibatalkan.

  • Tunggu sekurang-kurangnya 60 minit, dikira dari created_at tugas, sebelum anda berhenti menunggu. Jika anda berhenti lebih awal, anda mungkin terlepas tugas yang berjaya kemudian. Ini kebanyakannya berlaku semasa tempoh sibuk.
  • Simpan ID tugas. Anda boleh mendapatkan tugas itu semula pada bila-bila masa. Jika ia masih belum muktamad selepas 60 minit, semak semula kemudian. Jika ia kekal sedemikian, hubungi sokongan.
  • Hanya FAILED bermaksud tugas gagal. Meshy mengembalikan kredit secara automatik untuk tugas yang gagal.

Gunakan nilai berikut dalam kod anda:

TetapanNilai yang disyorkan
Timeout permintaan buat (POST)60 saat
Timeout permintaan buat (POST) dengan fail model_url melebihi 100 MB120 saat. Meshy memuat turun fail itu sebelum ia memberi respons.
Timeout permintaan status (GET)30 saat
Selang pollHeader Retry-After, atau 5 saat jika ia tiada. Poll dikira ke arah had kadar anda.
Permintaan status gagal (timeout, 429, atau 5xx)Cuba semula pada poll seterusnya. Ini tidak bermaksud tugas gagal.
Jumlah masa menunggu setiap tugasSekurang-kurangnya 60 minit dari created_at. Jangan mulakan semula kiraan ini apabila anda menyambung semula strim.
StrimStrim boleh tertutup sebelum tugas selesai. Jika ia tertutup tanpa status akhir, sambung semula atau tukar kepada poll.

Untuk banyak tugas sekali gus, gunakan webhooks sebagai ganti kepada poll setiap satu. Jika acara akhir sesuatu tugas tidak tiba selepas kira-kira dua kali ganda masa biasanya, dapatkan tugas itu daripada endpoint GET-nya.