lowpoly 将于 2026年10月30日 下线。 meshy-7 作为 3D 生成模型将于 2026年12月31日 下线;作为贴图模型仍可使用。 请在这些日期前切换模型,以免请求报错。 查看所有弃用信息

资产保留期

了解 Meshy 保留你生成的文件的时长,以及如何保留自己的副本。


Meshy 对通过 API 生成的模型最多保留 3 天。此后,Meshy 会将其从服务器上删除。

如果你不是企业版客户,并且需要更长时间保留模型,请下载并保存自己的副本。

企业版客户可以无限期保留他们的模型。

下载 URL 是签名的

任务的 model_urls、texture_urls 和 thumbnail_url 中的 URL 指向 assets.meshy.ai,并带有签名(?Expires=…&Signature=…)。URL 会在任务的 expires_at 时失效。再次获取该任务会返回带有相同过期时间的相同 URL。

Text to 3D 任务没有 expires_at,或者该字段为 null,其 URL 不带过期时间。但这并不意味着 Meshy 会保留该任务。除非你是企业版客户,否则 Meshy 会在任务完成 3 天后删除该任务:此后获取该任务会返回 404,其文件也会随后被移除。请在 3 天内下载所需内容。

因此,请遵循以下规则:

  • 当任务状态变为 SUCCEEDED 时下载文件,如果需要更长时间保留模型,请保存自己的副本。
  • 不要存储下载 URL,以便之后将其作为 model_url 发回给 Meshy,例如用于可打印性分析、可打印性修复或 Remesh。签名过期后,该请求会失败并返回 400 failed to download model file。
  • 当 Meshy 仍保留源任务时,请改为将其 ID 作为 input_task_id 发送。此后,该任务会返回 404 Task not found,因此请发送你自己保存的副本。