弃用
查看哪些 Meshy AI 模型和 API 功能处于启用、deprecated 或已停用状态,并了解其停用日期和推荐替代方案。
随着 Meshy 发布新模型,旧模型会被停用。依赖旧模型或 API 功能的集成可能需要偶尔更新才能继续正常工作。本页列出了每一项 API 弃用,以及对应的推荐替代方案。
概述
Meshy 使用以下术语来描述模型或 API 功能的生命周期:
- 启用中: 完全受支持,推荐使用。
- Legacy: 不再接收更新,未来可能会被 deprecated。它仍然可以正常工作,你的请求和账单都不会有任何变化。
- Deprecated: 仍然可以正常工作,但不再推荐使用。Meshy 会指定一个推荐的替代方案,一旦安排好,还会给出停用日期。
- 已停用: 不再可用。使用已停用模型或功能的请求会返回错误。
停用某个模型不会删除你已经用它生成的内容。使用已停用模型创建的任务仍会在通常的留存期内保持可用。
迁移到替代方案
一旦某个模型被 deprecated,请在停用日期之前将所有请求迁移到其替代方案。停用日期之后使用该模型的请求将会失败。
替代方案产生的结果可能与它所替代的模型不同。请在停用日期之前充分测试你的集成与替代方案的兼容性,例如在 Playground 中进行测试。
通知
Meshy 会在更新日志和本页面上公布每一次弃用和停用。在即将停用期间,每个 API 页面顶部都会显示一条横幅提示,相应的 endpoint 页面也会将该模型或参数标记为 deprecated。
Meshy 会在停用前至少一个月公布停用日期。
最佳实践
- 定期查看更新日志和本页面,了解弃用相关的更新。
- 如果你的集成需要保持一致的输出,请将
ai_model设置为具体的模型,例如meshy-7.1。latest始终指向最新的标准模型,因此当发布新模型时,其输出会发生变化。 - 在当前模型的停用日期之前,充分测试你的集成与替代方案的兼容性。
- 尽快更新你的代码,以使用推荐的替代方案。
- 如果在迁移过程中需要帮助,请联系 support@meshy.ai。
模型状态
Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture 当前及已停用的 3D 生成模型。并非每个 endpoint 都提供所有模型;每个 endpoint 页面会列出其支持的模型。
| API 模型名称 | 当前状态 | 已弃用 | 停用日期 |
|---|---|---|---|
meshy-7.1 | 启用中 | 不适用 | 不适用 |
meshy-7 | Deprecated | 2026 年 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-t1 | Deprecated | 2026 年 7 月 13 日 | 2026 年 11 月 30 日 |
model_type: "lowpoly" | Deprecated | 2026 年 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-02 | Text to 3D 和 Image to 3D 上的 model_type: "lowpoly" 和 meshy-t1 | 2026 年 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-7 | 2026 年 12 月 31 日 | meshy-7.1 |
| 2026-09-16 | 共享测试模式 API key | 2026 年 9 月 16 日 | 来自 API Keys 页面的你自己的 key,或 Playground |
| 2026-09-11 | meshy-5 | 2026 年 10 月 10 日 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 2026 年 3 月 20 日 | meshy-6 |
| 2025-10-01 | Text to Voxel API | 2025 年 10 月 1 日 | 无 |
| 2025-07-01 | Text to Texture API | 2025 年 7 月 1 日 | Retexture |
| 2025-01-14 | meshy-3 | 2025 年 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 日 deprecated | ultra_mode: true 等同于 geometry_resolution: "2k"。 | geometry_resolution |
hd_texture | 于 2026 年 7 月 21 日 deprecated | hd_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 |