更新日志

查看 Meshy API 和插件的所有最新功能和更新。

2026年9月

Sep 3

  • Creative Lab Lamp API 的原型阶段现在会返回一个 3D 模型：POST /prototype 会将概念图转换为空心灯罩 GLB，原型任务对象在 image_urls 之外新增了 model_urls.glb 和 thumbnail_url。构建阶段只会对该模型运行灯具处理器，现在生成的是一个底部开口、带有光源固定装置底板的灯罩。Pricing 也随之调整：原型阶段为 30 credits，构建阶段为 6 credits（此前分别为 6 和 30）。原型阶段的 text 参数已被移除——image_url 为必填项。

Sep 1

  • 在 Multi-Image to 3D API 中新增了 ultra_mode 参数：在 ai_model 为 meshy-7（或 latest）时启用 Ultra 生成模式，可获得更高保真度的 geometry 和更精细的表面细节，额外花费 5 credits —— 这与 Image to 3D API 提供的 Ultra 处理相同，现在多视图输入也可使用该功能。
  • 从 Image to 3D API 的 Smart Topology model_type 所记录的 ai_model 取值中移除了 meshy-t1。Smart Topology 现在只记录 meshy-t2，新接入的集成应改用该模型。Meshy T1 计划被弃用 —— 如果你的集成目前发送的是 ai_model: "meshy-t1"，请迁移至 meshy-t2。

2026年8月

Aug 28

  • 为 Studio 和 Enterprise 团队新增了使用情况 API：以编程方式导出历史 API 任务使用情况——包括 endpoint、状态、时间戳、运行每个任务的 API key，以及 consumed_credits——并支持标准的分页以及按时间范围、endpoint 和状态进行筛选，方便成本跟踪和财务系统使用。

Aug 26

  • Animation API 现在支持 motion_task_id——可将通过文本生成动作 API 生成的动作片段应用到你的双足骨骼绑定角色上，作为预设 action_id 的替代方案。每个任务仍为 3 credits。

Aug 24

  • 为 文字生成影像 和 影像生成影像 API 中的 gpt-image-2 扩展了 aspect_ratio 支持，新增 16:9 和 9:16。gpt-image-2 现已支持 1:1、16:9、9:16、3:2 和 2:3；该模型仍不支持 4:3 和 3:4。

Aug 21

  • 新增 Text to Motion API：无需角色模型，即可根据自然语言描述生成角色动作片段。选择 prime mode（10 credits，输出 FBX）以获得最高质量，或选择 swift mode（3 credits，输出 BVH）以实现快速、经济的生成，片段时长为 2–10 秒。

Aug 20

  • 在多色打印 API中新增了 style 参数：选择 realistic（默认）以获得贴图精确的颜色，或选择 cartoon 以获得扁平、均匀的色块区域和更小的 3MF 文件。
  • 为每个 Creative Lab 原型 endpoint 新增了 remove_background 参数 —— Figure、Vinyl Figure、Brick Figure、Keycap、Keychain、Fridge Magnet 和 Lamp。将 remove_background 设置为 true 即可获得已移除背景、带透明通道的 RGBA PNG 原型图像。

Aug 18

  • 在 Multi-Image to 3D API 中新增了 texture_image_urls 参数：可提供 1–4 张同一物体的图片来指导贴图生成，取代单一的 texture_image_url。该参数需要 ai_model 为 meshy-7 或 latest，且与 image_urls 相互独立——这两个列表可以包含不同的图片及不同数量的图片。

Aug 17

  • 在 Text to Image API 和 Image to Image API 中新增了 remove_background 参数。设置 remove_background: true 即可获得已移除背景的透明 RGBA PNG 生成图像。

Aug 13

  • 在 Text to 3D API 中新增了 ai_model: "meshy-7"：这是我们最新的 3D 生成模型，其 geometry 保真度高于 Meshy 6。它还在 preview 任务中引入了 ultra_mode 参数，只需额外花费 5 credits 即可启用 Ultra 生成，获得更精细的表面细节。要使用 Meshy 7 进行 texture 处理，请在 refine 任务中传入 ai_model: "meshy-7"，或者完全省略 ai_model 参数。
  • 在 Text to 3D API 中新增了 Smart Topology model_type。设置 model_type: "smart-topology" 即可使用 meshy-t2 进行生成——具备更简洁的 topology、原生分离的部件、三角形输出，并且可以通过 target_polycount（100 到 15,000，默认 4,000）设置面数。一次 Smart Topology 的 preview 仅需 5 credits，而不是 20；详见 Pricing。现有的 model_type: "lowpoly" 现已 deprecated，但为保持向后兼容性仍会继续提供服务。

Aug 12

  • 在 Image to 3D API 中新增了 ai_model: "meshy-7"：我们最新的 3D 生成模型，相比 Meshy 6 具有更高保真度的 geometry。它还引入了 ultra_mode 参数，可启用 Ultra 生成以获得更精细的表面细节。
  • 在 Multi-Image to 3D API 中新增了 ai_model: "meshy-7"：Meshy 的多视图生成模型，可同时基于你所有的输入视图进行条件生成，并以此驱动贴图生成。
  • 在 Retexture API 中新增了 ai_model: "meshy-7"：我们最新的贴图模型，相比 Meshy 6 具有更清晰的表面细节和更干净的 PBR 材质。它还引入了 multiview_image_urls 参数——提供同一物体的 1 至 4 张有序视图，即可驱动多视图贴图生成。

Aug 4

  • 为 可打印性分析 和 可打印性修复 端点扩展了 model_url 输入支持，新增 .glb、.gltf、.obj、.fbx、.stl（此前仅支持 .glb、.stl、.obj）。修复功能会以输入格式返回修复后的资产。

July 2026

Jul 27

  • 全新 Creative Lab — 方块小人 API：将照片转换为方块风格的可收藏 3D 小人偶。采用与 Figure API 相同的两阶段工作流程 —— prototype（6 credits）生成风格化概念图像，build（30 credits）将其转换为带贴图的 3D 模型，输出 GLB 和 OBJ + MTL 格式。完整费用明细请参见 Pricing。

Jul 22

  • 新增 Creative Lab — 键帽 API：将一张照片转化为全彩定制机械键盘键帽。两阶段工作流程——prototype（12 credits）生成成品键帽设计渲染图，随后 build（50 credits）将你选定的设计（通过 candidate_id）转化为带贴图的 3D 键帽模型，并以 GLB 和 OBJ 包形式输出，按真实毫米比例导出。目前支持标准 Cherry MX 1u 基座（cherry-mx-1x1-r1）；更多标准尺寸正在规划中。完整费用明细请参见 Pricing。

Jul 21

  • 我们现在通过一个新增的 texture_resolution 参数（2k / 4k / 8k）在 Image to 3D、Multi-Image to 3D、Text to 3D Refine 以及 Retexture 各 endpoint 上支持了 8K 基础色 texture。在 8k 档位下，PBR 贴图将以 4K 分辨率生成，且不会生成 emission 贴图。8K texture 生成费用为 15 credits（2k/4k 仍为 10 credits）。详见 Pricing。
  • hd_texture 布尔 参数已 deprecated，取而代之的是 texture_resolution —— 出于向后兼容考虑，该 参数 仍然有效，等同于 texture_resolution: "4k"。

Jul 20

  • 新增 Creative Lab — Vinyl Figure API：将照片转换为大头 Vinyl 收藏手办 3D 模型。与 Figure API 相同的两阶段工作流程 —— prototype（6 credits）生成风格化概念图像，build（30 credits）将其转换为带贴图的 3D 模型，输出 GLB 和 OBJ + MTL。完整费用明细请参见 Pricing。

Jul 13

  • 为 Image to 3D API 新增了 Smart Topology model_type，通过 ai_model 提供两种模型：meshy-t1 —— 当前的 low-poly 模型，以及 meshy-t2 —— 一个新模型，具有更简洁的 topology、原生分离的部件、三角形输出，并可通过 target_polycount 设置面数。meshy-t2 是 smart-topology 下的默认模型。现有的 model_type: lowpoly 现已 deprecated，但仍会继续处理请求以保持向后兼容。

Jul 7

  • 为 影像生成影像 API 添加了 aspect_ratio 参数，让您在编辑时可以控制输出图像的比例。nano-banana 模型允许的取值为 1:1、16:9、9:16、4:3、3:4，gpt-image-2 允许的取值为 1:1、3:2、2:3。该参数为可选项，默认值为 1:1，且不能与 generate_multi_view 同时使用。

June 2026

Jun 17

  • 新增 API Playground 文档页面：一个交互式控制台，让您无需编写代码即可试用各个 endpoint，然后复制相应的 cURL、Python 或 JavaScript 代码。该功能适用于 Pro、Premium、Ultra、Studio 和 Enterprise 套餐。

Jun 15

  • 新增 UV Unwrap API：为现有 3D 模型生成高质量的 UV 布局——这是纹理贴图之前的必要步骤，也适用于任何需要为下游工具准备干净、无重叠 UV 布局的场景。可传入 input_task_id（已完成的 Image to 3D、Text to 3D 或 Remesh 任务）或 model_url（仅限 .glb），并返回一个具有全新 UV 坐标的“UV 白模”。每次调用消耗 5 credits。支持最多 40,000 面的网格（若面数更多，请先运行 Remesh）；四边形和多边形网格会在 UV 生成过程中被三角化。

Jun 12

  • 已将 Creative Lab API 的 Build 定价更新为每次调用 30 credits，适用于 Keychain、Fridge Magnet 和 Figure（此前为 20）。Lamp 保持不变，仍为 30 credits。Prototype 定价保持不变，仍为每张图片 6 credits。完整明细请参见 Pricing。

Jun 5

Jun 1

  • 新增 Creative Lab API：一组以产品为范围的 endpoint，可将一张源照片（或文本 prompt）转换为可 3D 打印的消费类产品。首批上线四款产品——Keychain、Fridge Magnet、Figure 和 Lamp。每款产品都遵循两阶段的 prototype → build 工作流，通过 input_task_id 串联，并在以产品为范围的 URL（/openapi/creative-lab/<product>/v1/...）下提供服务，每个产品拥有独立的版本控制，便于各产品沿各自独立的版本线演进。Prototype：每次调用 6 credits。Build：每次调用 30 credits。

May 2026

May 26

  • 在 Multi-Image to 3D API 中新增了 multi_view_thumbnails 参数。当设置为 true 时，任务会额外渲染四个基准视角（正面、右侧、背面、左侧）的缩略图，并通过新的 thumbnail_urls 响应字段返回。现有的 thumbnail_url 字段保持不变。此选项会使任务延迟增加约 3 秒。

May 22

  • Remesh API 中的 convert 和 resize 功能现已作为独立的 Convert API 和 Resize API endpoint 提供。Remesh 上已 deprecated 的参数仍将继续可用，以保持向后兼容。

5月13日

  • 为 Image to 3D API 新增了 multi_view_thumbnails 参数。设置为 true 时，任务会额外渲染四个基本视角（正面、右侧、背面、左侧）的缩略图，并通过新的 thumbnail_urls 响应字段返回。现有的 thumbnail_url 字段保持不变。此功能会使任务延迟增加约 3 秒。

5月12日

  • 为 Remesh API 新增了 resize_longest_side 参数。该参数会调整模型大小，使包围盒最长的维度等于指定值（单位：米）。与 resize_height 和 auto_size 互斥。

May 11

May 7

  • 新增 可打印性分析 API：分析已成功完成的 Meshy 任务——或任意 3D 模型 URL——以评估其 FDM 3D 打印就绪程度。采用异步创建 + 流式模式：POST 请求返回一个 task_id，随后 GET / SSE 流会在状态变为 SUCCEEDED 后返回水密性、体积、孔洞和非流形边等指标。免费，不消耗 credits。
  • 新增 可打印性修复 API：修复 3D 模型以提升其 FDM 可打印性——修复非流形边、退化面、孔洞及其他 topology 问题。可接受已有的 Meshy input_task_id，或传入 model_url（.glb、.stl、.obj）。输出格式与输入保持一致。每个任务消耗 10 credits。

2026年4月

Apr 27

  • 在所有 API endpoint 的任务响应中新增了 consumed_credits 字段，用于显示每个任务所消耗的 credits 数量。该字段会出现在处于 PENDING、IN_PROGRESS 和 SUCCEEDED 状态的任务中。对于 FAILED 任务则返回 0（失败时会自动退还 credits）。各 endpoint 的积分费用请参见 Pricing。

Apr 24

  • 为 Multi-Color Print endpoint 新增了 model_url 参数。可直接提交带贴图的 3D 模型（通过 URL 或 Data URI），而无需使用先前 Meshy 任务生成的 input_task_id。支持的格式：.glb、.fbx。当同时提供 model_url 和 input_task_id 时，input_task_id 具有更高的优先顺序。

Apr 21

  • 在 Image to 3D 和 Multi-Image to 3D 端点中新增了 input_task_id 参数。可直接引用已完成的 文字生成影像 或 影像生成影像 任务的输出，而无需提供 image_url / image_urls。当两者同时提供时，input_task_id 具有更高的优先顺序。

Apr 20

Apr 14

Apr 12

  • 重构了 API 文档：新增了带有依赖字段的参数分组、行内默认值、必填/deprecated 徽章、可展开的子导航，并将 Multi-Image、骨骼绑定和 Animation 拆分为独立页面。

2026年3月

Apr 2

  • 在所有 endpoint（Image to 3D、Text to 3D、Remesh、Retexture）的 target_formats 参数中新增 3mf 格式支持。注意：3MF 为可选项，必须显式请求才会生效。
  • 全新 多色打印 API：将 3D 模型 Convert 为多色 3MF 格式，用于 3D 打印。支持 1-16 色调色板，并可配置精度。每个任务消耗 10 credits。

Mar 20

  • 已停用 Meshy-4 AI 模型。所有使用 meshy-4 的 API 请求将不再受支持。请迁移至 meshy-6 或 latest。
  • 在 Image to 3D、Multi-Image to 3D、Text to 3D 和 Remesh endpoint 中新增了 auto_size 和 origin_at 参数。启用 auto_size 后，服务会使用 AI 视觉估算真实世界的高度并自动调整模型尺寸。origin_at 用于设置原点位置（bottom 或 center）。在 Remesh API 中，auto_size 与 resize_height 互斥，不能同时使用。

3月17日

2026 年 2 月

2月28日

  • 为 Image to 3D、Multi-Image to 3D、Text to 3D Refine 和 Retexture API 添加了 remove_lighting 参数。该参数会从基础颜色 texture 中移除高光和阴影，从而在自定义光照下获得更干净的效果。仅支持 meshy-6 和 latest。默认为 true。
  • Retexture 和 Text to 3D Refine API 现已支持将 meshy-6 作为 ai_model 的取值，以实现完整的 Meshy 6 texturing。

Feb 25

  • 为 Image to 3D 和 Multi-Image to 3D API 新增了 image_enhancement 参数，供希望不启用输入图像优化、保留输入图像原始外观的用户使用。仅支持 meshy-6 和 latest。默认值为 true。

Feb 20

  • 为 Text to 3D Preview API 新增了 model_type 参数，用于生成经过优化、拥有更简洁多边形的 low-poly 网格。

2026年1月

Jan 27

  • 为所有 API 端点新增了详细的失败模式文档，包括常见的 HTTP 错误代码（400、401、402、404、422、429）以及任务失败原因。这有助于开发者更好地理解和处理 API 错误。

Jan 26

  • Multi-Image to 3D API 现已支持 Meshy-6 进行完整网格生成。ai_model 参数现已支持 meshy-6，且 latest 现指向 Meshy 6。

Jan 22

  • 已弃用 Text to 3D Preview API（Meshy-6）中的 art_style 参数。该参数是为 Legacy 模型（Meshy-4 / Meshy-5）设计的，将在未来的版本中移除。
  • 当 ai_model 为 meshy-4 时，已弃用 Text to 3D 和 Image to 3D API 中的 enable_pbr 参数。该参数将在未来的版本中移除。
  • 更新了 Text to 3D 和 Image to 3D API 中 Meshy-6 的 should_remesh 参数的默认值。如果未指定，该参数在 meshy-6 中现在默认为 false，在其他模型中默认为 true。

1月19日

1月12日

  • 在 Image to 3D API 中新增了 model_type 参数，用于生成经过优化、多边形更简洁的 low-poly 网格。

2025年12月

12月31日

  • 推出了 API Playground，这是一个专为开发者打造的空间，可直接在 Meshy 官网探索 API 参数并测试请求。
  • 推出了 Text to Image API 和 Image to Image API，支持通过文本提示生成 AI 驱动的图像，以及基于参考图像进行图像编辑。这两个 API 均支持 nano-banana 和 nano-banana-pro 模型，并可选启用多视图生成。

Dec 22

  • Text to 3D API 响应中的 video_url 字段现已 deprecated，并将在未来版本中移除。

Dec 04

2025年11月

Nov 24

  • Image to 3D 和 Multi-Image to 3D API 新增了可选参数 save_pre_remeshed_model，并在请求了 Remesh 前备份时暴露 model_urls.pre_remeshed_glb。

Nov 06

  • Text to 3D Refine API 现已支持 ai_model = latest，该值会解析为 Meshy 6 Preview。
  • Image to 3D API 在 ai_model = latest 且 should_texture = true 时，现默认使用 Meshy-6-preview 进行贴图处理。
  • Multi-Image to 3D API 现已支持 ai_model = latest，默认使用 Meshy-6-preview 进行贴图处理，而网格生成仍使用 Meshy-5。
  • Retexture API 为 ai_model 新增了 latest 选项（Meshy-6-preview），并在未指定时默认使用该选项。

Nov 04

  • Remesh API 现在会为上传的模型保留贴图。
  • 启用 enable_original_uv 选项后，Retexture API 现在会为上传的模型保留贴图。

2025 年 10 月

Oct 28

  • 新增了 x-api-version 响应头，用于指示当前 API 服务器版本。

Oct 20

  • 为 Remesh API 新增了可选的 convert_format_only 布尔类型参数，用于支持仅转换输入模型文件的格式。
  • 在骨骼绑定任务对象的响应中新增了 rigged_character_glb_url。

Oct 01

  • 移除 text-to-voxel API

2025 年 9 月

Sep 23

  • 在 Text to 3D API 中为 ai_model 新增了 latest 选项，用于使用 Meshy 6 Preview。
  • 针对 Meshy-6-preview 生成任务临时提供 50% 折扣，费用降至 10 credits，该优惠将持续至 2025 年 9 月 30 日。折扣期结束后，Meshy-6-preview 任务的费用将恢复至正常的 20 credits。

Sep 18

Sep 16

  • 在 Image to 3D API 的 ai_model 中新增了 latest 选项，以使用 Meshy 6 Preview。

Sep 4

  • 为 Remesh 和 Retexture 扩展了 model_url 输入支持，现支持 .glb、.gltf、.obj、.fbx、.stl。

August 2025

Aug 18

Aug 13

  • Meshy 5 现已针对 Text to 3D 和 Image to 3D（ai_model：meshy-5）稳定发布，带来更出色的质量与一致性。

2025 年 7 月

Jul 31

2025年6月

Jun 25

  • 新增了 Retexture API，允许用户基于 Meshy 最新的基础 AI 模型对 3D 模型进行 Retexture。

Jun 19

Jun 17

6月10日

  • Remesh API 现已支持通过 Data URI 在 model_url 参数中传入 base64 编码的 GLB 格式模型。

2025年5月

5月20日

5月15日

2025年4月

4月29日

  • 推出了 Multi-Image to 3D API，允许使用 meshy-5 AI 模型从 1 到 4 张输入图片生成 3D 模型。
  • 在 Text to 3D 和 Image to 3D API 中新增了 meshy-5 AI 模型选项。latest 标签现在也会指向 meshy-5。

Apr 17

  • 在 Image to 3D 和 Text to 3D Refine API 中新增了 texture_image_url 参数，允许用户通过图片来引导 texture 生成过程。

2025 年 3 月

Mar 28

  • 在 Text to 3D 和 Image to 3D API 中新增了 latest 参数，可用于访问我们即将推出的先进 AI 模型，以提升生成质量。

Mar 14

  • Text to Texture API 现已支持在 model_url 参数中通过 Data URI 传递 base64 编码的模型，用法与 Image to 3D API 中的 image_url 类似。

Mar 06

  • 更新了 API 生成任务的 Pricing：
    • Text to 3D（Preview）：每次调用消耗的 credits 从 2 增加到 5
    • Text to 3D（Refine）：每次调用消耗的 credits 从 5 增加到 10
    • Image to 3D：现在不带 texture 为 5 credits，带 texture 为 15 credits
    • Text to Texture：每次调用消耗的 credits 从 5 增加到 10
    • Text to Voxel：保持每次调用 5 credits 不变

2025年2月

Feb 18

  • 新增了测试模式金钥，允许开发者在不消耗 credits 的情况下测试 API 集成。所有使用该 key 的有效请求都将返回相同的示例任务结果。

Feb 13

  • 重大变更：

    • 免费层任务创建将于 2025年3月20日 结束。此后，所有 API 任务请求都将需要付费 subscription。为了保证您的访问不受影响，我们建议您在截止日期前完成升级。
    • 使用优惠码 APIACCESS 即可享受 40% 折扣。感谢您一直以来的支持！

  • 新增了用于实时任务更新的 Server-Sent Events (SSE) 流式 endpoint：

Feb 6

  • 在 Image to 3D 和 Text to 3D Refine API 中新增了 texture_prompt 参数，允许用户通过文本 prompt 来引导 texture 生成过程。

January 2025

Jan 23

Jan 14

  • 已废弃由 Meshy-3 AI 模型驱动的旧版 Text to 3D 和 Image to 3D API。

Jan 07

December 2024

Dec 19

  • 新增了 Remesh API，允许用户对其他 Meshy API 生成的现有 3D 模型进行 Remesh 并导出为多种格式。
  • 将我们 API 的 polycount 限制更新为 Premium 用户的 100-300,000 范围。

Dec 12

  • 已弃用所有响应对象中的 model_url 属性。
  • 已将 legacy Meshy-3 API 与最新的 Meshy-4 API 分离。

Dec 10

Dec 5

Dec 3

  • 外部 API 现在使用 /openapi 前缀。Legacy 路径仍然受支持，但我们建议切换到新路径。

2024 年 11 月

Nov 14