當您透過 Meshy API 生成 3D 資產時，每個任務結果都會暫時儲存在 Meshy 的伺服器上。了解保留期限有助於規劃您的整合流程，並確保您在輸出過期前完成下載。
各任務類型的資產保留期限
保留期限因任務類型而異：
任務類型 | 保留期限 |
Text to 3D | 任務完成後 3 天 |
Image to 3D | 任務完成後 3 天 |
Rigging | 任務完成後 2 個月 |
Text to 3D 與 Image to 3D
任務及其輸出——模型檔案、預覽圖與貼圖——自任務完成起會保留 3 天。超過此期限後，任務及所有相關的下載連結將無法再存取。
每個 API 任務回應都包含一個 expires_at 欄位（Unix 時間戳，單位為毫秒），明確指出任務將被刪除的時間：
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
請在您的整合中監控此數值，並在其到期前觸發下載。
Rigging 任務
Rigging 任務在完成後會保留 2 個月。這段較長的保留期讓您可以使用原始 rig 任務 ID，繼續為同一個已綁定骨架的角色加入新的動畫——無需重新對網格進行綁定。
若要為現有的 rig 製作動畫，只要在 2 個月的保留期限內，即可在動畫請求中引用該 rig 任務 ID。
擷取您的資產
若要在 API 生成的資產過期前存取它們：
立即下載。 一旦任務達到
SUCCEEDED狀態，請立即將輸出檔案（GLB、FBX、OBJ 等）下載到您自己的儲存空間。使用列出任務的端點。 透過 Text to 3D 或 Image to 3D 的列表 API 端點擷取最近的任務 ID 與輸出連結。
常見問題
1. 為什麼我透過 API 生成的模型沒有出現在我的工作區中？
這是預期行為。API 生成的資產 不會 顯示在 Meshy 工作區介面中。這是有意為之的設計——API 與工作區擁有各自獨立的資產生命週期，並適用不同的到期規則。
2. 為什麼我的任務 URL 會回傳 404？
如果任務的 expires_at 時間戳已過，該資產已從 Meshy 的伺服器上刪除。您將需要重新提交生成任務。為避免未來再次發生此情況，請設定在任務成功後自動下載至您自己的儲存空間。
3. rig 任務過期後，我還能為角色加入新的動畫嗎？
Rigging 任務會保留 2 個月，讓您有充裕的時間繼續加入動畫。如果 rig 任務已過期（超過 2 個月），您將需要對原始網格重新進行綁定。
注意：Meshy 不保證不同綁定執行之間的骨架相容性。