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

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

各类任务的资产保留期限

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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