弃用说明
查看哪些 Meshy AI 模型和 API 功能处于活跃、deprecated 或已停用状态，并了解停用日期和推荐的替代方案。
随着 Meshy 发布新模型，旧模型会被停用。依赖旧模型或 API 功能的集成可能需要偶尔更新才能继续正常工作。本页列出了所有 API 弃用情况，以及各自推荐的替代方案。
概述
Meshy 使用以下术语来描述模型或 API 功能的生命周期：
- 活跃（Active）： 完全受支持，推荐使用。
- Legacy： 不再接收更新，未来可能会被标记为 deprecated。它仍然可以使用，你的请求和账单不会受到任何影响。
- Deprecated： 仍然可以使用，但不再推荐。Meshy 会指定推荐的替代方案，并在确定之后给出停用日期。
- 已停用（Retired）： 不再可用。使用已停用模型或功能的请求将返回错误。
停用一个模型不会删除你之前用它生成的内容。使用已停用模型创建的任务仍会在通常的保留期内保持可用。
迁移到替代方案
一旦某个模型被标记为 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 模型名称 | 当前状态 | Deprecated 日期 | 停用日期 |
|---|---|---|---|
meshy-7.1 | 活跃 | 无 | 无 |
meshy-7 | Deprecated | 2026 年 9 月 18 日 | 待公布 |
meshy-6 | 活跃 | 无 | 无 |
meshy-6-lite | 活跃 | 无 | 无 |
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 年 10 月 30 日 |
model_type: "lowpoly" | Deprecated | 2026 年 7 月 13 日 | 2026 年 10 月 30 日 |
latest 解析为 meshy-7.1。
弃用历史
以下列出了所有弃用情况，按公告时间从新到旧排列。
| 公告日期 | 被弃用的模型或功能 | 停用日期 | 推荐替代方案 |
|---|---|---|---|
| 2026-10-02 | Text to 3D 和 Image to 3D 上的 model_type: "lowpoly" 和 meshy-t1 | 2026 年 10 月 30 日 | 配合 ai_model: "meshy-t2.5" 使用的 model_type: "smart-topology" |
| 2026-09-29 | 不带 /openapi 前缀的 /v2/text-to-3d | 待公布 | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 | 待公布 | meshy-7.1 |
| 2026-09-16 | 共享的测试模式 API key | 2026 年 9 月 16 日 | 你自己在 API Keys 页面获取的密钥，或使用 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 | 仍然可以使用。该图像会成为绑定骨骼后模型的唯一 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 和 Resize 参数 | 2026 年 5 月 22 日起 deprecated | 仍然可以使用。 | Convert 和 Resize |
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 |