跳至主要內容

Meshy 會保留 API 產出素材多久

Meshy API 素材保留與下載指南

目錄

當您透過 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 時間已過,因此素材已被刪除。請重新提交任務,並在任務成功後立即設定自動下載到您自己的儲存空間。


相關文章

這是否解答了您的問題?