lowpoly 將於 2026年10月30日 下線。 請在這些日期前切換模型,以免請求出錯。 查看所有棄用資訊

資產保留期

了解 Meshy 對你產生的檔案會保留多長時間,以及如何儲存你自己的副本。


對於透過 API 產生的模型,Meshy 最多保留 3 天。之後,Meshy 會將其從伺服器中刪除。

如果你不是企業版客戶,並且需要更長時間保留模型,請下載並儲存你自己的副本。

企業版客戶可以無限期保留他們的模型。

下載連結帶有簽名

任務的 model_urls、texture_urls 和 thumbnail_url 中的 URL 指向 assets.meshy.ai,並帶有簽名(?Expires=…&Signature=…)。URL 會在任務的 expires_at 時失效。再次取得該任務會傳回相同的 URL 和相同的過期時間。

文字生成 3D 任務沒有 expires_at,或者其值為 null,其 URL 也不帶過期時間。但這並不代表 Meshy 會一直保留該任務。除非你是企業版客戶,否則 Meshy 會在任務完成 3 天後刪除該任務:之後再次取得會傳回 404,其檔案也會隨後被移除。請在 3 天內下載你需要的內容。

因此,請遵循以下規則:

  • 在任務達到 SUCCEEDED 狀態時下載檔案,如果需要更長時間保留模型,請儲存你自己的副本。
  • 不要儲存一個下載連結以便稍後作為 model_url 回傳給 Meshy,例如用於可列印性分析、可列印性修復或 重構網格。簽名過期後,該請求會失敗,並傳回 400 failed to download model file。
  • 只要 Meshy 仍保留來源任務,就改為傳送其 ID 作為 input_task_id。此後,該任務會傳回 404 Task not found,因此請傳送你自己儲存的副本。