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.