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.
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.PENDINGIN_PROGRESSSUCCEEDEDFAILEDTugas 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.
| Status | Apa yang sepatutnya dilakukan oleh kod anda |
|---|---|
PENDING | Terus menunggu. |
IN_PROGRESS | Jejaki progress: peratusan kerja yang telah selesai, 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 buat tugas baharu. Lihat Ralat. |
CANCELED | Berhenti 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:
Permintaan: POST/image-to-3d
Respons: 202{ "result": "<task_id>" }tugas 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 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.
Ini adalah masa biasa, bukan masa penyiapan yang dijamin. Semasa tempoh sibuk, sesetengah tugas 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 |
|---|---|---|---|---|---|
| Text to 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.
Pengteksturan
| API | Resolusi tekstur | Masa biasa |
|---|---|---|
| Text to 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 |
Pemprosesan pasca
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 | Bahagian berwarna rata | 70 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_attugas, 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
FAILEDbermaksud tugas gagal. Meshy mengembalikan kredit secara automatik untuk tugas yang gagal.
Gunakan nilai berikut dalam kod anda:
| Tetapan | Nilai yang disyorkan |
|---|---|
Timeout permintaan buat (POST) | 60 saat |
Timeout permintaan buat (POST) dengan fail model_url melebihi 100 MB | 120 saat. Meshy memuat turun fail itu sebelum ia memberi respons. |
Timeout permintaan status (GET) | 30 saat |
| Selang poll | Header 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 tugas | Sekurang-kurangnya 60 minit dari created_at. Jangan mulakan semula kiraan ini apabila anda menyambung semula strim. |
| Strim | Strim 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.