# Meshy 保留 API 生成资产多长时间

> URL: https://help.meshy.ai/zh-CN/articles/15643844-how-long-does-meshy-keep-api-generated-assets
> Language: zh-CN
> Last updated: 2026-08-27T10:20:30Z

当您通过 Meshy API 生成 3D 资产时，每个任务的结果都会临时存储在 Meshy 的服务器上。了解保留期限有助于您规划集成方案，并确保在结果过期前完成下载。

## 各类任务的资产保留期限

保留期限因任务类型而异：

| 任务类型   | 保留期限       |
| ------ | ---------- |
| 文本转 3D | 任务完成后 3 天  |
| 图像转 3D | 任务完成后 3 天  |
| 骨骼绑定   | 任务完成后 2 个月 |

### 文本转 3D 和图像转 3D

任务及其输出（模型文件、预览图和纹理）自任务完成起保留 **3 天**。超过这个期限后，该任务及其所有关联的下载 URL 都将无法访问。

每个 API 任务响应中都包含 `expires_at` 字段（以毫秒为单位的 Unix 时间戳），准确指明该任务将在何时被删除：

```
{
  "id": "01abc123-...",
  "status": "SUCCEEDED",
  "expires_at": 1777029052743,
  "result": {
    "model_urls": { ... }
  }
}
```

请在集成中监控这个值，并在它到期之前触发下载。

### 骨骼绑定任务

骨骼绑定任务在完成后保留 **2 个月**。这段更长的期限让您可以使用原始绑定任务 ID，继续为同一个已绑定的角色添加新动画，而无需重新绑定网格。

要为已有的骨骼绑定添加动画，只需在 2 个月保留期内的任意时间，在动画请求中引用该绑定任务 ID 即可。

## 获取您的资产

要在 API 生成的资产过期前访问它们：

- **立即下载**。任务一进入 `SUCCEEDED` 状态，就把输出文件（GLB、FBX、OBJ 等）下载到您自己的存储中。

- **使用任务列表端点**。通过文本转 3D 或图像转 3D 的列表 API 端点获取最近的任务 ID 和输出 URL。

## 常见问题

**1. 为什么我通过 API 生成的模型没有出现在工作区中？**

这是预期行为。API 生成的资产 *不会* 出现在 Meshy 工作区界面中。这是有意为之的设计：API 和工作区拥有各自独立的资产生命周期，过期规则也不同。

**2. 为什么我的任务 URL 返回 404？**

如果任务的 `expires_at` 时间戳已经过去，该资产就已从 Meshy 的服务器上删除。您需要重新提交生成任务。为避免以后再次发生，请在任务成功后立即自动下载到您自己的存储中。

**3. 骨骼绑定任务过期后，我还能为角色添加新动画吗？**

骨骼绑定任务可保留 2 个月，为您留出充足的时间继续添加动画。如果绑定任务已经过期（超过 2 个月），您需要对原始网格重新进行骨骼绑定。

请注意：Meshy 不保证不同绑定任务之间的骨骼兼容性。