Kitaran hayat tugasan
Pelajari cara tugasan bergerak daripada permintaan kepada hasil, berapa lama biasanya ia mengambil masa, dan berapa lama kod anda perlu menunggu untuknya.
Bagaimana tugasan berjalan
Permintaan create mengembalikan ID tugasan tanpa menunggu tugasan itu berjalan. Tugasan itu kemudian berjalan di latar belakang, dan anda menjejakinya dengan salah satu daripada tiga cara: tinjau (poll) endpoint GET-nya, buka endpoint stream-nya, atau terima webhook.
PENDING. Seorang pekerja (worker) mengambilnya dan ia bergerak ke IN_PROGRESS, di mana ia menghabiskan kebanyakan masanya. Ia berakhir dalam SUCCEEDED atau FAILED, dan status akhir tidak pernah berubah.PENDINGIN_PROGRESSSUCCEEDEDFAILEDTugasan merekodkan setiap langkah dalam medan created_at, started_at, dan finished_at.
Jadual berikut menunjukkan apa yang kod anda perlu lakukan pada setiap status.
| Status | Apa yang kod anda perlu lakukan |
|---|---|
PENDING | Teruskan menunggu. |
IN_PROGRESS | Jejaki progress: peratusan kerja yang telah siap, dari 0 hingga 100. |
SUCCEEDED | Muat turun hasil. Meshy menyimpan fail untuk tempoh masa yang terhad. Lihat Pengekalan aset. |
FAILED | Baca task_error, kemudian betulkan input atau cipta tugasan baharu. Lihat Ralat. |
CANCELED | Berhenti menunggu. Tugasan tidak akan menghasilkan apa-apa hasil. Hanya tugasan Creative Lab menggunakan status ini. |
SUCCEEDED, FAILED, dan CANCELED adalah muktamad. Selepas tugasan mencapai salah satu daripadanya, statusnya tidak pernah berubah lagi.
Dari sudut kod anda, ia kelihatan seperti ini:
Permintaan: POST/image-to-3d
Respons: 202{ "result": "<task_id>" }tugasan dicipta
- Ulang setiap beberapa saat
Permintaan: GET/image-to-3d/<task_id>
Respons: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5
Permintaan: GET/image-to-3d/<task_id>
Respons: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }
GET semula ia kemudian dengan ID tugasan yang sama.Masa pemprosesan
Jadual berikut menunjukkan masa median pada trafik API produksi pada September 2026.
Satu masa berjalan dari penciptaan tugasan hingga status akhir. Hampir semuanya adalah pemprosesan, kerana tugasan biasanya kekal dalam PENDING hanya untuk beberapa saat. Apabila baris gilir sibuk, tugasan boleh menunggu lebih lama sebelum ia bermula, dan tugasan pada pelan dengan keutamaan yang lebih tinggi biasanya bermula lebih awal.
Masa di bawah 2 minit adalah dalam saat (s), dan masa yang lebih lama adalah dalam minit (min). Tidak disokong bermaksud API tidak menawarkan pilihan itu dengan model tersebut.
Ini adalah masa biasa, bukan masa penyiapan yang dijamin. Semasa tempoh sibuk, sesetengah tugasan mengambil masa lebih lama dan masih berjaya. Untuk menyemak status Meshy, lihat halaman status. Jangan gunakan masa ini sebagai timeout dalam kod anda. Untuk nilai timeout, lihat Berapa lama untuk menunggu.
Penjanaan 3D
| API | Konfigurasi | meshy-7.1 (latest) | meshy-6 | meshy-6-lite | meshy-t2 |
|---|---|---|---|---|---|
| Teks ke 3D (Preview) | Jejaring sahaja | 75 s | 90 s | 45 s | 10 s |
| Imej ke 3D | Jejaring sahaja | 75 s | 90 s | 40 s | 4 s |
| Jejaring dengan tekstur 2K | 2 min | 3 min | 75 s | 60 s | |
| Jejaring dengan tekstur 4K | 2.5 min | 3.5 min | Tidak disokong | 80 s | |
| Jejaring dengan tekstur 8K | 3.5 min | 4 min | Tidak disokong | 2.5 min | |
| Berbilang Imej ke 3D | Jejaring sahaja | 65 s | 2 min | 30 s | Tidak disokong |
| Jejaring dengan tekstur 2K | 2.5 min | 3.5 min | 85 s | Tidak disokong | |
| Jejaring dengan tekstur 4K | 3 min | 4 min | Tidak disokong | Tidak disokong | |
| Jejaring dengan tekstur 8K | 3.5 min | 4.5 min | Tidak disokong | Tidak 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.
Pentekstur-an
| API | Resolusi tekstur | Masa biasa |
|---|---|---|
| Teks ke 3D (Refine) | 2K atau 4K | 80 s |
| 8K | 3.5 min | |
| Retekstur | 2K | 55 s |
| 4K | 90 s | |
| 8K | 2.5 min |
Penjanaan imej
| API | nano-banana | nano-banana-2 | nano-banana-pro | Model GPT Image |
|---|---|---|---|---|
| Teks ke Imej | 20 s | 15 s | 25 s | 20 hingga 35 s |
| Imej ke Imej | 40 s | 20 s | 30 s | 20 hingga 40 s |
Rigging dan Animasi
| API | Konfigurasi | Masa biasa |
|---|---|---|
| Auto-Rigging | Rigging automatik | 40 s |
| Animasi | Setiap permintaan | 15 s |
| Text to Motion | mode prime | 15 s |
mode swift | 10 s |
Pasca-pemprosesan
Pencetakan 3D
| API | Konfigurasi | Masa biasa |
|---|---|---|
| Analisis kebolehcetakan | Semakan jejaring sahaja | 1 s |
| Semakan jejaring dan dinding nipis | 10 s | |
| Multi-Color | Setiap permintaan | 30 s |
| Baiki kebolehcetakan | Baik pulih jejaring sahaja | 10 s |
| Semakan dinding nipis, dinding dikekalkan | 20 s | |
| Semakan dinding nipis, dinding ditebalkan | 100 s | |
| Auto Split | Setiap permintaan | 70 s |
Pada v2, Baiki kebolehcetakan dan Analisis kebolehcetakan sentiasa menjalankan semakan dinding nipis. Pada v1, ia menjalankannya apabila anda menghantar jenis pencetak atau saiz cetakan.
Berapa lama untuk menunggu
Tugasan terus berjalan walaupun kod anda berhenti menunggu. Jika permintaan anda timeout, sambungan anda terputus, atau stream anda ditutup, tugasan tidak gagal dan tidak dibatalkan.
- Tunggu sekurang-kurangnya 60 minit, dikira daripada
created_attugasan, sebelum anda berhenti menunggu. Jika anda berhenti lebih awal, anda mungkin terlepas tugasan yang berjaya kemudian. Ini berlaku kebanyakannya semasa tempoh sibuk. - Simpan ID tugasan. Anda boleh mendapatkan semula tugasan itu pada bila-bila masa. Jika ia masih belum muktamad selepas 60 minit, semak semula kemudian. Jika ia kekal begitu, hubungi sokongan.
- Hanya
FAILEDbermaksud tugasan gagal. Meshy mengembalikan kredit secara automatik untuk tugasan yang gagal.
Gunakan nilai berikut dalam kod anda:
| Tetapan | Nilai yang disyorkan |
|---|---|
Timeout permintaan create (POST) | 60 saat |
Timeout permintaan create (POST) dengan fail model_url melebihi 100 MB | 120 saat. Meshy memuat turun fail sebelum ia memberi respons. |
Timeout permintaan status (GET) | 30 saat |
| Selang tinjauan (poll) | Header Retry-After, atau 5 saat jika ia tiada. Tinjauan (poll) dikira terhadap had kadar anda. |
Permintaan status gagal (timeout, 429, atau 5xx) | Cuba lagi pada tinjauan (poll) seterusnya. Ia tidak bermaksud tugasan gagal. |
| Jumlah masa menunggu setiap tugasan | Sekurang-kurangnya 60 minit dari created_at. Jangan mulakan semula kiraan ini apabila anda menyambung semula stream. |
| Stream | Stream boleh ditutup sebelum tugasan selesai. Jika ia ditutup tanpa status akhir, sambung semula atau tukar kepada tinjauan. |
Untuk banyak tugasan sekali gus, gunakan webhooks dan bukannya meninjau (poll) setiap satu. Jika acara akhir sesuatu tugasan belum tiba selepas kira-kira dua kali ganda masa biasanya, dapatkan tugasan itu daripada endpoint GET-nya.