# Meshy 保留 API 生成資產多久？

> URL: https://help.meshy.ai/zh-Hant/articles/15643844-how-long-does-meshy-keep-api-generated-assets
> Language: zh-Hant
> Last updated: 2026-09-09T10:13:06Z

當您透過 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 不保證不同綁定執行之間的骨架相容性。