Apabila anda menjana aset 3D melalui Meshy API, setiap hasil tugasan disimpan buat sementara waktu pada pelayan Meshy. Memahami tempoh penahanan membantu anda merancang integrasi anda dan memastikan anda memuat turun output sebelum ia tamat tempoh.
Tempoh Penahanan Aset Mengikut Jenis Tugasan
Tempoh penahanan berbeza mengikut jenis tugasan:
Jenis Tugasan | Tempoh Penahanan |
Text to 3D | 3 hari selepas tugasan selesai |
Image to 3D | 3 hari selepas tugasan selesai |
Rigging | 2 bulan selepas tugasan selesai |
Text to 3D dan Image to 3D
Tugasan dan outputnya — fail model, imej pratonton, dan tekstur — disimpan selama 3 hari dari masa tugasan selesai. Selepas tempoh ini, tugasan dan semua URL muat turun yang berkaitan tidak akan lagi boleh diakses.
Setiap respons tugasan API termasuk medan expires_at (cap masa Unix dalam milisaat) yang menunjukkan dengan tepat bila tugasan akan dipadamkan:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Pantau nilai ini dalam integrasi anda dan mencetuskan muat turun sebelum ia tamat tempoh.
Tugasan Rigging
Tugasan rigging disimpan selama 2 bulan selepas selesai. Tempoh lanjutan ini membolehkan anda terus menambah animasi baharu pada watak yang sama yang telah di-rig menggunakan ID tugasan rig yang asal — tanpa perlu merig semula mesh tersebut.
Untuk menganimasikan rig sedia ada, rujuk ID tugasan rig dalam permintaan animasi anda pada bila-bila masa dalam tempoh penahanan 2 bulan tersebut.
Mendapatkan Semula Aset Anda
Untuk mengakses aset hasil janaan API sebelum ia tamat tempoh:
Muat turun dengan segera. Sebaik sahaja tugasan mencapai status
SUCCEEDED, muat turun fail output (GLB, FBX, OBJ, dll.) ke storan anda sendiri.Guna endpoint senarai tugasan. Dapatkan ID tugasan terkini dan URL output melalui endpoint API senarai Text to 3D atau Image to 3D.
FAQ
1.Mengapa model hasil janaan API saya tidak muncul dalam workspace saya?
Ini adalah tingkah laku yang dijangkakan. Aset hasil janaan API tidak muncul dalam UI Meshy Workspace. Ini adalah secara sengaja direka — API dan Workspace mempunyai kitaran hayat aset yang berasingan dengan peraturan tamat tempoh yang berbeza.
2.Mengapa url tugasan saya memulangkan 404?
Jika cap masa expires_at tugasan telah berlalu, aset telah dipadamkan dari pelayan Meshy. Anda perlu menghantar semula tugasan penjanaan. Untuk mengelakkan perkara ini pada masa hadapan, sediakan muat turun automatik ke storan anda sendiri sebaik sahaja tugasan berjaya.
3.Bolehkah saya menambah animasi baharu pada watak selepas tugasan rig tamat tempoh?
Tugasan rigging tersedia selama 2 bulan, memberikan anda tempoh yang mencukupi untuk terus menambah animasi. Jika tugasan rig telah tamat tempoh (lebih daripada 2 bulan), anda perlu merig semula mesh yang asal.
Nota: Meshy tidak menjamin keserasian skeleton antara pelaksanaan rigging yang berasingan.