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

弃用

查看哪些 Meshy AI 模型和 API 功能处于启用、deprecated 或已停用状态,并了解其停用日期和推荐替代方案。

随着 Meshy 发布新模型,旧模型会被停用。依赖旧模型或 API 功能的集成可能需要偶尔更新才能继续正常工作。本页列出了每一项 API 弃用,以及对应的推荐替代方案。


概述

Meshy 使用以下术语来描述模型或 API 功能的生命周期:

  • 启用中: 完全受支持,推荐使用。
  • Legacy: 不再接收更新,未来可能会被 deprecated。它仍然可以正常工作,你的请求和账单都不会有任何变化。
  • Deprecated: 仍然可以正常工作,但不再推荐使用。Meshy 会指定一个推荐的替代方案,一旦安排好,还会给出停用日期。
  • 已停用: 不再可用。使用已停用模型或功能的请求会返回错误。

停用某个模型不会删除你已经用它生成的内容。使用已停用模型创建的任务仍会在通常的留存期内保持可用。


迁移到替代方案

一旦某个模型被 deprecated,请在停用日期之前将所有请求迁移到其替代方案。停用日期之后使用该模型的请求将会失败。

替代方案产生的结果可能与它所替代的模型不同。请在停用日期之前充分测试你的集成与替代方案的兼容性,例如在 Playground 中进行测试。


通知

Meshy 会在更新日志和本页面上公布每一次弃用和停用。在即将停用期间,每个 API 页面顶部都会显示一条横幅提示,相应的 endpoint 页面也会将该模型或参数标记为 deprecated。

Meshy 会在停用前至少一个月公布停用日期。


最佳实践

  1. 定期查看更新日志和本页面,了解弃用相关的更新。
  2. 如果你的集成需要保持一致的输出,请将 ai_model 设置为具体的模型,例如 meshy-7.1。latest 始终指向最新的标准模型,因此当发布新模型时,其输出会发生变化。
  3. 在当前模型的停用日期之前,充分测试你的集成与替代方案的兼容性。
  4. 尽快更新你的代码,以使用推荐的替代方案。
  5. 如果在迁移过程中需要帮助,请联系 support@meshy.ai。

模型状态

Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture 当前及已停用的 3D 生成模型。并非每个 endpoint 都提供所有模型;每个 endpoint 页面会列出其支持的模型。

API 模型名称当前状态已弃用停用日期
meshy-7.1启用中不适用不适用
meshy-7Deprecated2026 年 9 月 18 日2026 年 12 月 31 日(geometry);不适用(texture)
meshy-6启用中不适用不适用
meshy-6-lite启用中不适用不适用
meshy-n1启用中不适用不适用
meshy-5已停用2026 年 9 月 11 日2026 年 10 月 10 日
meshy-4已停用不适用2026 年 3 月 20 日
meshy-3已停用2025 年 1 月 14 日2025 年 7 月
meshy-t2.5启用中不适用不适用
meshy-t2启用中不适用不适用
meshy-t1Deprecated2026 年 7 月 13 日2026 年 11 月 30 日
model_type: "lowpoly"Deprecated2026 年 7 月 13 日2026 年 11 月 30 日

latest 解析为 meshy-7.1。

meshy-7 的停用涵盖其作为 Text to 3D preview 任务、Image to 3D 和 Multi-Image to 3D 的 ai_model 时的情况。meshy-7.1 接受相同的参数,费用也相同。自 2026 年 12 月 31 日起,这些请求将返回 400。

meshy-7 作为 texture 模型不受影响。这涵盖 Retexture、texture_model,以及 Text to 3D refine 的 ai_model(它只选取 texture 模型)。

截至 2026 年 11 月 30 日之前,以下请求仍会在具有三角形 topology 的 Smart Topology 模型上运行,并按 Smart Topology 的价格收费:

  • 使用 model_type: "smart-topology" 和 ai_model: "meshy-t1" 的 Image to 3D 请求,或者省略 ai_model(即使用 latest 或 meshy-6)并使用 model_type: "lowpoly" 的请求。Meshy 会忽略其中的 target_polycount、topology、image_enhancement、remove_lighting 和 experimental 参数。
  • 使用 model_type: "lowpoly" 且省略 ai_model(即使用 latest、meshy-6 或 meshy-4,其中 meshy-4 本已停用,这里仅作为该回退方案而被接受)的 Text to 3D preview 请求。Meshy 会忽略其中的 target_polycount、topology 和 experimental 参数。

其他所有使用 meshy-t1 或 lowpoly 的请求现在已经返回 400。从 2026 年 11 月 30 日起,上述这些请求也将返回 400。


弃用历史

下表列出了所有弃用记录,最新公布的排在最前面。

公布日期被弃用的模型或功能停用日期推荐替代方案
2026-10-02Text to 3D 和 Image to 3D 上的 model_type: "lowpoly" 和 meshy-t12026 年 11 月 30 日model_type: "smart-topology" 配合 ai_model: "meshy-t2.5"
2026-09-29不带 /openapi 前缀的 /v2/text-to-3d待公布/openapi/v2/text-to-3d
2026-09-18作为 Text to 3D preview、Image to 3D 和 Multi-Image to 3D 的 ai_model 的 meshy-72026 年 12 月 31 日meshy-7.1
2026-09-16共享测试模式 API key2026 年 9 月 16 日来自 API Keys 页面的你自己的 key,或 Playground
2026-09-11meshy-52026 年 10 月 10 日meshy-6-lite
2026-03-20meshy-42026 年 3 月 20 日meshy-6
2025-10-01Text to Voxel API2025 年 10 月 1 日无
2025-07-01Text to Texture API2025 年 7 月 1 日Retexture
2025-01-14meshy-32025 年 7 月meshy-6

API 参数弃用

Meshy 偶尔会弃用一些被更新模型替代或不再使用的请求参数与响应字段。除非另有说明,它们仍然可以正常工作,但未来的版本可能会将其移除。

参数状态行为推荐替代方案
Rigging 上的 texture_image_url于 2026 年 10 月 23 日 deprecated仍可正常工作。该图像会成为 rigged 模型的唯一 texture,模型将失去其 PBR 贴图。省略该参数。Meshy 会使用 model_url 或输入任务的 texture。
ultra_mode于 2026 年 9 月 18 日 deprecatedultra_mode: true 等同于 geometry_resolution: "2k"。geometry_resolution
hd_texture于 2026 年 7 月 21 日 deprecatedhd_texture: true 等同于 texture_resolution: "4k"。如果两者同时发送,Meshy 会使用 texture_resolution。texture_resolution
Remesh 的 Convert 和尺寸调整参数于 2026 年 5 月 22 日 deprecated仍可正常工作。Convert 和尺寸调整
symmetry_mode于 2026 年 5 月 11 日 deprecated接受但会被忽略。省略该参数。
Text to 3D Preview 上的 art_style于 2026 年 1 月 22 日 deprecated接受但会被忽略。此前它仅适用于 Meshy 4 和 Meshy 5。省略该参数。
is_a_t_pose于 2025 年 12 月 4 日 deprecated仍可正常工作。pose_mode