更新日志

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

2026年8月

Aug 28

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

Aug 26

  • Animation API 现已支持 motion_task_id —— 可将通过 Text to Motion API 生成的动作片段应用到已完成骨骼绑定的双足角色上，作为预设 action_id 的替代方案。每个任务同样消耗 3 credits。

Aug 24

  • 扩展了 Text to Image 和 Image to Image 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（默认）以获得与 texture 一致的真实色彩，或选择 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 生成模型，相较 Meshy 6 拥有更高保真度的 geometry。它还在 preview task 中引入了 ultra_mode 参数，该参数可启用 Ultra 生成模式，以额外 5 credits 获得更精细的表面细节。要使用 Meshy 7 进行 texture 处理，请在 refine task 中传入 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 credits；详见 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 — Keycap API：将一张照片转化为全彩定制机械键盘键帽。分两个阶段的工作流程——prototype（12 credits）生成成品键帽设计渲染图，随后 build（50 credits）会将你选定的设计（通过 candidate_id 指定）转换为带贴图的 3D 键帽模型，输出 GLB 和 OBJ 打包文件，并按真实世界的毫米比例导出。目前支持标准 Cherry MX 1u 底座（cherry-mx-1x1-r1）；更多标准尺寸正在规划中。完整费用明细请参见 Pricing。

Jul 21

  • 我们现在通过 Image to 3D、Multi-Image to 3D、Text to 3D Refine 和 Retexture 端点上新增的 texture_resolution 参数（2k / 4k / 8k）支持 8K 基础色 texture。在 8k 档位下，PBR 贴图将以 4K 分辨率生成，且不会生成 emission 贴图。8K texture 生成消耗 15 credits（2k/4k 仍为 10）。详见 Pricing。
  • hd_texture 布尔值已 deprecated，改由 texture_resolution 取代——为保持向后兼容，该参数仍然有效，等同于 texture_resolution: "4k"。

Jul 20

  • 全新 Creative Lab — Vinyl Figure API：将一张照片转换为大头乙烯基收藏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 设置面数的全新模型。在 smart-topology 下，meshy-t2 为默认模型。现有的 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 同时使用。

2026年6月

Jun 17

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

6 月 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

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

Jun 5

Jun 1

  • 全新 Creative Lab APIs：这是一系列面向特定产品的 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。

2026年5月

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 端点提供。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 互斥。

5 月 11 日

5 月 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月

4月27日

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

4月24日

  • 为多色打印 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 endpoint 中新增了 input_task_id 参数。可直接引用已完成的 Text to Image 或 影像生成影像 任务的输出，而无需提供 image_url / image_urls。当两者同时提供时，input_task_id 具有更高的优先顺序。

Apr 20

Apr 14

Apr 12

  • 重构了 API 文档：新增了带依赖字段的参数分组、内联默认值、必填/deprecated 徽章、可展开的子导航，并将 Multi-Image、Rigging 和 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 用于设置 origin 位置（bottom 或 center）。在 Remesh API 中，auto_size 与 resize_height 互斥。

Mar 17

February 2026

Feb 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 texture 生成功能。

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月

1月27日

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

1月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。

Jan 19

Jan 12

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

December 2025

Dec 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 参数，用于支持仅转换输入模型文件的格式。
  • 在 The Rigging Task Object 的响应中新增 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 模型进行重新贴图。

Jun 19

Jun 17

6月10日

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

2025年5月

5月20日

May 15

April 2025

Apr 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

March 2025

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）：每次调用从 2 credits 增加到 5 credits
    • Text to 3D（Refine）：每次调用从 5 credits 增加到 10 credits
    • Image to 3D：现为不带 texture 5 credits，带 texture 15 credits
    • Text to Texture：每次调用从 5 credits 增加到 10 credits
    • Text to Voxel：保持每次调用 5 credits

2025年2月

Feb 18

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

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 标记为 deprecated。

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