Saat Anda menghasilkan aset 3D melalui API Meshy, setiap hasil tugas disimpan sementara di server Meshy. Memahami jangka waktu penyimpanan membantu Anda merencanakan integrasi dan memastikan Anda mengunduh output sebelum kedaluwarsa.
Masa Penyimpanan Aset Berdasarkan Jenis Tugas
Masa penyimpanan bervariasi berdasarkan jenis tugas:
Jenis Tugas | Masa Penyimpanan |
Text to 3D | 3 hari setelah tugas selesai |
Image to 3D | 3 hari setelah tugas selesai |
Rigging | 2 bulan setelah tugas selesai |
Text to 3D dan Image to 3D
Tugas beserta outputnya — file model, gambar pratinjau, dan tekstur — disimpan selama 3 hari sejak tugas selesai. Setelah jangka waktu ini, tugas dan semua URL unduhan terkait tidak akan dapat diakses lagi.
Setiap respons tugas API mencakup field expires_at (stempel waktu Unix dalam milidetik) yang menunjukkan dengan tepat kapan tugas akan dihapus:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Pantau nilai ini dalam integrasi Anda dan picu pengunduhan sebelum nilai tersebut berlalu.
Tugas Rigging
Tugas rigging disimpan selama 2 bulan setelah selesai. Jangka waktu yang diperpanjang ini memungkinkan Anda untuk terus menambahkan animasi baru ke karakter yang telah di-rig menggunakan ID tugas rig yang asli — tanpa perlu melakukan rigging ulang pada mesh.
Untuk membuat animasi pada rig yang sudah ada, rujuk ID tugas rig dalam permintaan animasi Anda kapan saja dalam jangka waktu penyimpanan 2 bulan.
Mengambil Aset Anda
Untuk mengakses aset yang dihasilkan melalui API sebelum kedaluwarsa:
Unduh segera. Begitu tugas mencapai status
SUCCEEDED, unduh file output (GLB, FBX, OBJ, dll.) ke penyimpanan Anda sendiri.Gunakan endpoint daftar tugas. Ambil ID tugas terbaru dan URL output melalui endpoint API daftar Text to 3D atau Image to 3D.
FAQ
1. Mengapa model yang saya hasilkan melalui API tidak muncul di workspace saya?
Ini adalah perilaku yang wajar. Aset yang dihasilkan melalui API tidak muncul di UI Workspace Meshy. Ini memang disengaja — API dan Workspace memiliki siklus hidup aset yang terpisah dengan aturan kedaluwarsa yang berbeda.
2. Mengapa URL tugas saya mengembalikan 404?
Jika stempel waktu expires_at tugas telah terlewati, aset telah dihapus dari server Meshy. Anda perlu mengirimkan ulang tugas pembuatan. Untuk menghindari hal ini di masa mendatang, siapkan pengunduhan otomatis ke penyimpanan Anda sendiri segera setelah tugas berhasil.
3. Dapatkah saya menambahkan animasi baru ke karakter setelah tugas rig kedaluwarsa?
Tugas rigging tersedia selama 2 bulan, memberi Anda jangka waktu yang cukup untuk terus menambahkan animasi. Jika tugas rig telah kedaluwarsa (lebih dari 2 bulan), Anda perlu melakukan rigging ulang pada mesh asli.
Catatan: Meshy tidak menjamin kompatibilitas skeleton antara proses rigging yang terpisah.