lowpoly 将于 2026年10月30日 下线。 请在这些日期前切换模型，以免请求报错。 查看所有弃用信息

更新日志

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

更喜欢实时更新？最新条目也会显示在开发者平台概览页面上。

2026年10月

10月30日

  • Meshy T1（model_type: "lowpoly" 和 ai_model: "meshy-t1"）已在 Text to 3D 和 Image to 3D 中停用，由 model_type: "smart-topology" 配合 ai_model: "meshy-t2.5" 取而代之。
  • Auto Split API 新增了一个可选参数 keep_texture。设置 keep_texture: true 后，带贴图模型的每个部件都会保留贴图，任务会在 texture_urls 中返回贴图文件，并附带一个带有 OBJ 的 mtl 文件。若不设置此参数，拆分方式与之前相同。保留贴图的拆分耗时大约是原来的两倍，费用仍为 10 积分。input_task_id 现在也支持 Text to 3D 的 refine 和 Retexture 任务。

Oct 26

  • 新增 Deprecations 页面：记录了每个 3D 生成模型的生命周期（active、legacy、deprecated 或 retired）及其停用日期和推荐替代方案、每次 API 废弃的历史记录，以及仍在服务中的 deprecated 参数。API 页面上的停用横幅现在会链接到该页面。

Oct 23

  • 在 Rigging 中，texture_image_url 已被 deprecated。Meshy 会使用嵌入在 model_url 文件中的 texture，或者使用输入任务的 texture，因此当模型已有自带 texture 时，请不要传入该参数。如果你传入了它，该图片将成为 rigged 模型的唯一 texture，并且模型会失去其 PBR 贴图。

Oct 21

  • 为 Studio 和 Enterprise 团队的每个创建任务的 endpoint 添加了 X-Meshy-Metadata 头，Creative Lab endpoints 除外。使用你自己的键值对标记任务，例如 user=alex@example.com,team=fab，并在 Usage 记录的 metadata 字段中读取它们。参见 Metadata。

Oct 19

  • 在 Keychain 和 Fridge Magnet 构建任务中，export_resolution 现在最高接受 512，从之前的 2048 降低。512 是用于构建 geometry 的深度图分辨率，因此任何高于该值的设置都会在已有的采样点之间插入额外的顶点，从而生成描述同一表面但体积更大的文件。512 同时也是默认值，因此从未设置过 export_resolution 的调用方不会受到影响。现在，高于 512 的值会在创建任务时直接返回 400，而不再被接受。尤其是 2048，它总是会超出生成器的截止时间，并在任务开始后失败。如果你将 export_resolution 设置为高于 512 的值，请删除该参数或将其设为 512。

10月15日

  • 在 Image to 3D 和 Text to 3D API 中新增了 ai_model: "meshy-t2.5"：这是最新的 Smart Topology 模型，为游戏资产带来更锐利的细节表现。配合 model_type: "smart-topology" 使用；输出仅为三角面，target_polycount 支持 100 到 30,000（默认 15,000）。定价与 meshy-t2 相同；详见 Pricing。现在当仅设置 model_type: "smart-topology" 而未指定 ai_model 时，默认使用该模型；如需继续使用 Meshy T2，请设置 ai_model: "meshy-t2"。Multi-Image to 3D 暂不支持 meshy-t2.5。

Oct 14

  • 在 Retexture、Remesh、Rigging、Convert、尺寸调整、UV Unwrap、多色打印、可打印性分析 和 可打印性修复 中，当 model_url 为 http 或 https URL 时，现在最多可接受 400 MB 的文件，高于此前的 100 MB。data: URI 仍保持在 100 MB。超过 100 MB 的 GLB、glTF、FBX 或 OBJ 文件最多只能有 10,000,000 个面（多色打印为 8,000,000 个），以三角形计数；超过此数量的文件将返回 400。超过 100 MB 时，FBX 文件必须为二进制 FBX 7.1 或更高版本，且 GLB 或 glTF 文件不得使用 Draco 压缩。文件会在创建请求返回之前完成下载，因此大文件可能需要等待最长 120 秒（参见 Task Lifecycle）。100 MB 及以下的文件行为保持不变，定价也不受影响。
  • 可打印性分析 现在对属于其他账户的 input_task_id，会返回 404 及与不存在的 id 相同的响应体，而不是 403。属于您自己或您所在 workspace 中队友的任务，行为保持不变。

Oct 12

  • USDZ 文件现在使用米为单位，因此模型在 AR Quick Look、Reality Composer、Blender 和其他 USD 查看器中都会以真实大小打开。Text to 3D、Image to 3D、Multi-Image to 3D、Retexture、Remesh、Convert、尺寸调整 和 Auto Split 任务的 model_urls 中的 usdz 文件现在声明 metersPerUnit = 1。此前它声明的是英尺（metersPerUnit = 0.3048），而其坐标实际以米为单位，因此模型显示为实际大小的 30.48%。如果你此前通过将 USDZ 文件缩放 3.28 倍来进行补偿，请对从此日期起创建的任务移除该缩放。更早任务的文件将保持其当前单位不变，Rigging 和 Animation 的 USDZ 文件不受此变更影响。

Oct 10

  • meshy-5 已下线。向 Text to 3D、Image to 3D、Multi-Image to 3D 或 Retexture 发送 ai_model: "meshy-5" 的请求现在会返回 400，提示信息为 ai_model meshy-5 has been retired; use meshy-6-lite。请切换到 meshy-6-lite，其参数与积分消耗与原来相同。使用 meshy-5 已生成的模型仍可继续使用，并且在不设置 ai_model 的情况下对 meshy-5 的 preview 进行 refine 仍然有效。
  • 除 .jpg、.jpeg 和 .png 外，.webp 现已被正式列为 Image to 3D、Multi-Image to 3D、Image to Image、Retexture（image_style_url）以及 Text to 3D Refine（texture_image_url）支持的图像输入格式。该格式同时支持公开 URL 和 data URI（data:image/webp;base64,...）。现有集成不受影响，Pricing 也保持不变。
  • Get Balance 现在还会返回 monthly_credits、permanent_credits 和 monthly_resets_at，方便你了解在下次刷新时会有多少 balance 到期失效。balance 本身保持不变。

Oct 6

  • 可打印性分析和可打印性修复现在可以按照您计划打印的尺寸检查壁厚。发送 printer_type、打印尺寸或两者均可。分析功能会在 printability.thin_walls 中报告薄壁，修复功能会在需要时增厚薄壁部位，并且可以复用通过 input_task_id 传入的分析任务所使用的打印机和尺寸。不使用这些字段的集成方式行为保持不变，Pricing 也不受影响。

September 2026

Sep 29

  • 旧版 /v2/text-to-3d 路径（不带 /openapi 前缀）已被标记为 deprecated。目前它仍可正常使用，但未来版本中将被移除。请切换到 /openapi/v2/text-to-3d，该路径接受相同的请求并返回相同的响应。旧版路径的响应现在会携带 Deprecation 请求头以及指向新路径的 Link 请求头。

Sep 28

  • API 响应现在包含速率限制请求头，包括 Retry-After，用于告知你在重试或再次轮询前应等待的时长。
  • 多色打印新增了 printer_brand 参数，该参数会将匹配的 slicer 预设写入 3MF 文件，使该文件打开后即可直接用于 Anycubic、Creality、Elegoo、Flashforge、Prusa、Qidi、Snapmaker 和 AnkerMake 打印机，以及 Bambu Lab（默认选项）。该页面现在还记录了 max_depth 参数。

Sep 18

  • 为 Image to 3D、Multi-Image to 3D 和 Text to 3D 新增了 meshy-7.1 作为 ai_model 的取值：参数和积分消耗与 meshy-7 相同，但几何细节更高。latest 现在指向 meshy-7.1；meshy-7 已 deprecated，但仍可照常使用。
  • 为上述相同的 API 新增了 geometry_resolution（standard / 2k / 4k），用于替代现已 deprecated 的 ultra_mode（ultra_mode: true 仍可使用，等同于 "2k"）。4k 需要 Meshy 7.1（meshy-7.1 或 latest），在 Multi-Image to 3D 中 不可用，且与 2k 一样需要额外花费 5 积分。

Sep 16

  • Auto Split API 现在接受已带 texture 的 input_task_id。此前它会返回 400 拒绝该请求，这意味着需要先以 should_texture: false 重新生成同一个 mesh 才能进行拆分。拆分会切割 geometry 并重建每个部件的表面，因此输入的 texture 不会被保留，结果是一个未贴图的模型，每个部件呈现单一纯色。这一点在以往所有拆分中都是如此，并未发生变化。
  • meshy-5 将于 2026 年 10 月 10 日停用。在 Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture 的文档中，它已不再作为 ai_model 的可选值列出，10 月 10 日之后发送 ai_model: "meshy-5" 的请求将返回错误。
  • 共享的测试模式 API key 已停用；仍发送该 key 的请求现在会返回 401 Unauthorized。如果你曾将其复制到代码或 CI 中，请从 API Keys 页面 替换为你自己的 key。该 key 无论输入是什么，始终返回相同的示例模型，因此它从未真正展示过某个请求实际会生成什么结果。若想在正式构建之前查看 API 的实际返回效果，可以使用 Developer Platform 中的 Playground，它会在你的浏览器中运行一个真实任务。在没有 API 访问权限的套餐中，它会在不使用 API key 的情况下运行 Image to 3D，并像其他任务一样消耗你账户中的积分。

Sep 15

  • 已在 文字生成影像 和 影像生成影像 API 的 ai_model 文档值中新增 gpt-image-2-5-flare 和 gpt-image-2-5-sunburst。这些是 OpenAI GPT Image 2.5 系列的档位，定价与 gpt-image-2 相同（文字生成影像：9 积分；影像生成影像：12 积分）。
  • GPT Image 系列模型（gpt-image-2、gpt-image-2-5-flare、gpt-image-2-5-sunburst）现在除了支持 1:1、16:9、9:16、3:2 和 2:3 之外，在 文字生成影像 和 影像生成影像 API 中也支持 4:3 和 3:4 宽高比。

Sep 14

  • 影像生成影像 API 现在接受 input_task_id，因此你可以直接从已完成的 Text to Image 或 影像生成影像 任务进行链式调用，而无需将其输出 URL 复制到 reference_image_urls 中。

Sep 11

  • 行为变更：对已处于 IN_PROGRESS 状态的任务执行 DELETE 操作现在会被拒绝，并返回 409 Conflict，该任务将继续运行。此前该操作会返回 200 OK，停止工作进程并丢弃结果，但由于只有 PENDING 任务才可退款，因此仍会保留积分扣除。这样的调用会让你同时损失模型用量和积分，而响应中却没有任何提示。如果你的集成通过删除任务来取消任务，请注意：工作进程已经开始处理的任务是无法取消的。请等待任务变为 SUCCEEDED、FAILED 或 CANCELED 后再删除。PENDING 任务仍会按原来的方式被删除并退款，终态任务也仍会被删除。此变更适用于 /openapi 下的所有任务系列。详见 Errors。
  • 为 Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture API 的 ai_model 文档值中新增了 meshy-6-lite。它是 meshy-5 的继任者：参数相同，积分花费相同（mesh 为 5，带 texture 为 15，retexture 为 10）。
  • meshy-5 现已在所有接受该值的 API 中标记为 deprecated。它仍可正常使用，你的请求和账单都不会受到任何影响，但在未来版本中它将停止接受新流量。如果你的集成发送的是 ai_model: "meshy-5"，请迁移到 meshy-6-lite。

Sep 9

  • 新增 Auto Split API：将未贴图的 Meshy 6 或 Meshy 7 模型拆分为可单独打印的多个部件。可以自动拆分，也可以按你指定的部件名称拆分（by_parts），或按颜色区域拆分（by_color），并可选添加榫卯连接件和薄壁加固。每个部件都会导出为 glb、obj、fbx、usdz、blend 或 3mf 格式中的独立对象，支持以组装状态或按打印平台布局（layout）导出。每个任务消耗 10 积分。

Sep 7

  • 在 Creative Lab Keychain API 的原型阶段新增了 name_text 参数：可在钥匙扣上刻上最多 10 个字符的名字，这与 Web App 提供的个性化功能相同。构建阶段会自动继承该刻字内容，并且原型任务对象现在会返回 name_text，以便你在构建前确认具体文字。name 仍然只是一个用于显示的任务标签，不会被刻上去。

9 月 5 日

  • 新增 Creative Lab Fidget Pixel API：分两个阶段，将照片转换为可 3D 打印的多彩像素艺术指尖玩具板。POST /prototype（6 积分）将照片像素化为像素艺术图像。传入 type 为 person 或 other 以选择像素化风格。POST /build（30 积分）将其采样到 16 或 32 的网格上，并将每个像素转换为可互锁的 square 或 hex 拼块，最终以单个带颜色标记的 3MF 文件交付，用于多色材料打印。拼块的 geometry 可通过 piece_size_mm、color_count 和 piece_height_mm 进行调节。

Sep 4

  • 新增 GET /openapi/v1/animations/library 到 动画库：获取 Animation API 支持的所有预设动作（action_id、名称、分类，以及动画 GIF 预览），并支持搜索和分类筛选，让你可以构建自己的动作选择器，而不必查阅参考表格。免费，不消耗积分。
  • 新增 Creative Lab Collapsible Fidget API：将照片转换为可直接打印的可折叠解压玩具，主体的轮廓会变成可折叠展开的同心环，一体成型打印，无需组装。单次 POST 请求即可从图片一路生成到最终模型。没有 prototype/build 两阶段流程，也没有需要调整的 geometry 参数。每个任务消耗 6 积分，并返回可打印的 STL 文件和用于预览的 GLB 文件。

Sep 3

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

Sep 2

  • Animation API 现已支持 action_ids 参数，因此你可以在一次请求中对一个已绑定骨骼的角色应用多达 10 个预设动作，并获得一个包含每个动作对应动画片段的单一文件，可直接在游戏引擎中驱动状态机。片段会按照你列出的顺序排列，并带有该动画所属动画库的名称。每个动作消耗 3 积分，post_process 将应用于合并后的文件。可用的 id 请参见 动画库 Reference，费用请参见 pricing table。

Sep 1

  • 在 Multi-Image to 3D API 中新增了 ultra_mode 参数：可在 ai_model 为 meshy-7（或 latest）时启用 Ultra 生成模式，以获得更高保真度的 geometry 和更精细的表面细节，额外消耗 5 积分。这与 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月

8月28日

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

8月26日

  • Animation API 现已支持 motion_task_id，这样您就可以将使用 Text to Motion API 生成的动作片段应用到您的绑定双足角色（rig）上，作为预设 action_id 的替代方案。每个任务仍为 3 积分。

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 积分，输出 FBX）可获得最高质量，或选择 swift mode（3 积分，输出 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 生成模型，其 geometry 保真度高于 Meshy 6。它还在 preview 任务中引入了 ultra_mode 参数，该参数可启用 Ultra 生成模式，以额外 5 积分获得更精细的表面细节。要使用 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 积分，而非 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

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

July 2026

Jul 27

  • 全新 Creative Lab Brick Figure API：将一张照片转化为积木风格的可收藏 3D 小人偶。它采用与 Figure API 相同的两阶段工作流程。prototype（6 积分）生成风格化的概念图，build（30 积分）将其转化为带贴图的 3D 模型，并输出 GLB 和 OBJ + MTL 格式。完整价格明细请参阅 Pricing。

Jul 22

  • 新增 Creative Lab 键帽 API：将一张照片转化为全彩定制机械键盘键帽。它采用两阶段工作流程。prototype（12 积分）会生成一张成品键帽设计渲染图，然后 build（50 积分）会将你选中的设计（通过 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 endpoint 上新增的 texture_resolution 参数（2k / 4k / 8k）支持 8K 基础色 texture。在 8k 档位下，PBR 贴图会以 4K 分辨率生成，且不会生成 emission 贴图。8K texture 生成费用为 15 积分（2k/4k 仍为 10 积分）。详见 Pricing。
  • hd_texture 布尔参数已 deprecated，由 texture_resolution 取代。为保持向后兼容，该参数目前仍然有效，其效果等同于 texture_resolution: "4k"。

Jul 20

  • 新增 Creative Lab Vinyl Figure API：将一张照片转换为大头乙烯基（vinyl）收藏手办 3D 模型。它使用与 Figure API 相同的两阶段工作流程。prototype（6 积分）生成风格化概念图，build（30 积分）将其转换为带贴图的 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 积分。支持最多 40,000 个面的网格（如果超出该限制，请先运行 Remesh）；四边形和多边形网格会在 UV 生成过程中被三角化处理。

Jun 12

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

Jun 5

Jun 1

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

2026年5月

5月26日

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

5月22日

  • Remesh API 中的转换与尺寸调整功能现已作为独立的 Convert API 和 Resize API endpoint 提供。Remesh 上已 deprecated 的参数将继续保留以保证向后兼容。

May 13

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

May 12

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

May 11

May 7

  • 全新 Analyze Printability API：对已成功的 Meshy 任务或任意 3D 模型 URL 进行 FDM 3D 打印就绪性分析。采用异步创建 + 流式传输模式：POST 返回 task_id，随后 GET / SSE 流在状态为 SUCCEEDED 时返回水密性、体积、孔洞及非流形边等指标。免费，不消耗积分。
  • 全新 Repair Printability API：修复 3D 模型的 FDM 可打印性，修复非流形边、退化面、孔洞及其他 topology 问题。可接受现有 Meshy 的 input_task_id 或 model_url（.glb、.stl、.obj）。输出格式与输入一致。每个任务消耗 10 积分。

2026年4月

Apr 27

  • 在所有 API endpoint 的任务响应中添加了 consumed_credits 字段。该字段显示每个任务消耗的积分数量。此字段适用于处于 PENDING、IN_PROGRESS 和 SUCCEEDED 状态的任务。对于 FAILED 状态的任务，返回 0（失败时积分会自动退还）。各 endpoint 的积分消耗详情请参阅 Pricing。

Apr 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 端点中新增了 input_task_id 参数。可直接引用已完成的文字生成影像或影像生成影像任务的输出，而无需提供 image_url / image_urls。当两者同时提供时，input_task_id 的优先顺序更高。

Apr 20

Apr 14

Apr 12

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

2026年3月

4月2日

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

Mar 20

  • 已停用 Meshy-4 AI 模型。所有使用 meshy-4 的 API 请求将不再受支持。请迁移至 meshy-6 或 latest。
  • 为 Image to 3D、Multi-Image to 3D、Text to 3D 和 Remesh 端点新增了 auto_size 和 origin_at 参数。启用 auto_size 后，服务会使用 AI 视觉估算真实世界高度并自动调整模型尺寸。origin_at 用于设置原点位置（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

November 2025

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 积分，该优惠将持续到 2025 年 9 月 30 日。优惠期结束后，Meshy-6-preview 任务的费用将恢复为正常的 20 积分。

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。

2025 年 8 月

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

Jun 10

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

May 2025

May 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

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 积分提高到 5 积分
    • Text to 3D（Refine）：每次调用从 5 积分提高到 10 积分
    • Image to 3D：现在无 texture 时为 5 积分，有 texture 时为 15 积分
    • Text to Texture：每次调用从 5 积分提高到 10 积分
    • Text to Voxel：维持每次调用 5 积分不变

2025年2月

Feb 18

  • 新增了测试模式金钥，让开发者无需消耗积分即可测试 API 集成。使用此金钥发起的所有有效请求都将返回相同的示例任务结果。

Feb 13

  • 重大变更：

    • 免费层任务创建将于 March 20, 2025 结束。此后，所有 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 模型驱动的 Legacy Text to 3D 和 Image to 3D API。

Jan 07

2024 年 12 月

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