當您透過 Meshy API 生成 3D 素材時,每個任務及其產出內容都會在 Meshy 伺服器上保留有限時間。保留時間長短取決於您的帳戶方案,而非任務類型。請在產出內容到期前下載。
方案別素材保留期限
方案 | 保留期限 |
Pro、Premium、Ultra | 3 天 |
Studio | 14 天 |
Enterprise | 永久保留 |
保留期限適用於所有 API 任務類型,包括其產出內容——模型檔案、預覽圖片和貼圖。期限結束後,任務及其所有下載 URL 都會被刪除,且無法復原。
您可以在我們的定價頁面比較各方案。
查看任務到期時間
每個 API 任務回應都會包含 expires_at 欄位(Unix 毫秒時間戳),明確顯示該任務將被刪除的時間:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}請在您的整合服務中監控此值,並在期限屆滿前下載輸出。
取回您的素材
立即下載。 任務一旦達到
SUCCEEDED狀態,請立刻將輸出檔案(GLB、FBX、OBJ 等)下載到您自己的儲存空間。使用列出任務端點。 透過各任務類型的列出端點,取得最近的任務 ID 與輸出 URL。
常見問題
1. 為什麼找不到我產出的素材?
如果您沒有及時下載,素材會在保留期限結束時被刪除。已刪除的素材無法復原——您需要重新提交任務。
2. 若我呼叫 DELETE 刪除任務,我上傳的圖片和模型也會被刪除嗎?
刪除任務會永久刪除該任務,包括其模型和資料。刪除後無法復原,因此請先下載您需要的內容。
3. 為什麼我 API 生成的模型沒有出現在工作區?
這是預期行為。API 生成的素材不會出現在 Meshy Workspace 中——API 與 Workspace 的素材生命週期是分開的。
4. 為什麼我的任務 URL 傳回 404?
任務的 expires_at 時間已過,因此素材已被刪除。請重新提交任務,並在任務成功後立即設定自動下載到您自己的儲存空間。