Kapag gumawa ka ng 3D assets sa pamamagitan ng Meshy API, ang bawat resulta ng task ay pansamantalang iniimbak sa mga server ng Meshy. Ang pag-unawa sa retention window ay nakakatulong sa iyo na planuhin ang iyong integration at siguraduhing na-download mo ang mga output bago ito mag-expire.
Asset Retention ayon sa Uri ng Task
Naiiba ang retention period depende sa uri ng task:
Uri ng Task | Retention Period |
Text to 3D | 3 araw pagkatapos makumpleto ang task |
Image to 3D | 3 araw pagkatapos makumpleto ang task |
Rigging | 2 buwan pagkatapos makumpleto ang task |
Text to 3D at Image to 3D
Ang mga task at ang kanilang mga output — model files, preview images, at textures — ay pinapanatili sa loob ng 3 araw mula sa oras na makumpleto ang task. Pagkatapos ng panahong ito, hindi na ma-access ang task at lahat ng kaugnay na download URLs.
Ang bawat API task response ay may kasamang expires_at field (Unix timestamp sa milliseconds) na nagpapahiwatig kung kailan eksaktong buburahin ang task:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
I-monitor ang value na ito sa iyong integration at i-trigger ang mga download bago ito lumipas.
Rigging Tasks
Ang mga rigging task ay pinapanatili sa loob ng 2 buwan pagkatapos makumpleto. Ang pinalawak na panahong ito ay nagbibigay-daan sa iyo na magpatuloy sa pagdaragdag ng mga bagong animation sa parehong rigged na character gamit ang orihinal na rig task ID — nang hindi na kailangang i-rig muli ang mesh.
Para i-animate ang isang umiiral na rig, i-reference ang rig task ID sa iyong animation request anumang oras sa loob ng 2-buwang retention window.
Pagkuha ng Iyong mga Asset
Para ma-access ang mga API-generated na asset bago mag-expire ang mga ito:
Mag-download agad. Sa sandaling maabot ng task ang
SUCCEEDEDna status, i-download ang mga output file (GLB, FBX, OBJ, atbp.) sa sarili mong storage.Gamitin ang list tasks endpoint. Kunin ang mga kamakailang task ID at output URL sa pamamagitan ng Text to 3D o Image to 3D list API endpoints.
FAQ
1.Bakit hindi lumalabas ang aking API-generated na model sa aking workspace?
Inaasahan ito. Ang mga API-generated na asset ay hindi lumalabas sa Meshy Workspace UI. Sumasang-ayon ito sa disenyo — ang API at Workspace ay may magkakahiwalay na asset lifecycle na may magkaibang panuntunan sa expiration.
2.Bakit nagre-return ng 404 ang aking task urls?
Kung ang expires_at timestamp ng task ay lumipas na, nabura na ang asset sa mga server ng Meshy. Kailangan mong muling mag-submit ng generation task. Para maiwasan ito sa hinaharap, mag-set up ng automatic downloads sa sarili mong storage sa sandaling matagumpay ang mga task.
3.Makakapagdagdag ba ako ng mga bagong animation sa isang character pagkatapos mag-expire ang rig task?
Ang mga rigging task ay available sa loob ng 2 buwan, na nagbibigay sa iyo ng sapat na panahon para magpatuloy sa pagdaragdag ng mga animation. Kung nag-expire na ang rig task (higit sa 2 buwan), kailangan mong i-rig muli ang orihinal na mesh.
Paalala: Hindi ginagarantiya ng Meshy ang pagiging tugma ng skeleton sa pagitan ng magkakahiwalay na rigging runs.