lowpoly 将于 2026年10月30日 下线。 meshy-7 作为 3D 生成模型将于 2026年12月31日 下线;作为贴图模型仍可使用。 请在这些日期前切换模型,以免请求报错。 查看所有弃用信息

更新日志

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

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


2026年11月

Nov 18

  • 在 Rigging 中新增了四足动物 rigging 功能。发送 animation_type: "quadruped" 即可为四足动物添加 rig。该 rig 自带行走和奔跑两种 Animation。
  • Animation 可通过 action_id 或 action_ids 将 quadruped 类型的 Animation 应用到四足动物 rig 上。任何 quadruped Animation 都适用于任意四足动物 rig。四足动物 rig 及其每个 Animation 的费用与双足动物 rig 相同。
  • List animations 会为每个 Animation 返回 rig_type,取值为 biped 或 quadruped。一个 rig 只能使用与其自身类型相同的 Animation。

Nov 16

  • 在 浮雕 API 中新增了 color_mapping 和 target_formats。color_mapping: true 会使用照片为 GLB、OBJ、FBX 和 USDZ 文件上色,而 target_formats 会添加 OBJ、FBX、USDZ 和 3MF 文件。价格仍为 20 积分。

Nov 13

  • 新增 Meshy CLI 页面:安装 meshy 命令,通过浏览器登录(或在远程机器上使用设备代码),并使用 meshy make 生成你的第一个模型。该页面还介绍了用于脚本的 JSON 输出和退出代码、一个 GitHub Actions 示例,以及何时应使用 CLI 或 MCP server,AI 集成 现在也对两者进行了比较。

Nov 10

  • 在 Rigging 中新增了 skeleton_template。它会按照你的引擎或工具所需的骨骼交付双足角色,例如 mixamo 或 ue5_mannequin。Animation 任务会使用该 rig 的骨骼。v1 Rigging 的默认值仍为 meshyrig(与之前相同),v2 Rigging 的默认值为 mixamo。
  • 在 Rigging 中新增了 include_fingers。将其设置为 true 即可为双足角色的手部添加手指骨骼,适用于任何骨骼。
  • meshy-7 将于 2026 年 12 月 31 日作为 Text to 3D 预览任务、Image to 3D 和 Multi-Image to 3D 的 ai_model 退役。自该日期起,向这些 endpoint 发送 ai_model: "meshy-7" 的请求将返回 400。请切换到 meshy-7.1,它采用相同的参数且费用相同。meshy-7 作为 texture 模型将继续可用。这涵盖 Retexture、texture_model,以及 Text to 3D refine 的 ai_model。详见 Deprecations。

Nov 6

  • 在 文字生成影像 和 影像生成影像 API 的 ai_model 值中新增了 gpt-image-2-6-flare 和 gpt-image-2-6-sunburst。这两者是 OpenAI GPT Image 2.6 的分级版本:Flare 用于快速迭代,Sunburst 用于精细制作和精确编辑。它们支持的宽高比与其他 GPT Image 模型相同,所需积分也与 gpt-image-2 相同(文字生成影像:9 积分;影像生成影像:12 积分)。

Nov 5

  • 全新 Relief API:将一张照片转换为浮雕 3D 模型(GLB 和 STL)以及一张 16 位灰度深度图,适用于 3D 打印、激光雕刻和 CNC 雕刻。可通过可选参数设置尺寸、雕刻 mode 和深度、底座、弯曲度以及 mesh 分辨率,should_generate_model: false 则只返回深度图。每个任务消耗 20 积分。

Nov 3

  • 为 Image to 3D 和 Multi-Image to 3D 新增了 texture_model,让你可以在同一个任务中选择 texture 模型和 mesh。Image to 3D 支持 Meshy 7(meshy-7)、Meshy N1(meshy-n1)和 Meshy 6 Lite(meshy-6-lite),可搭配任意 ai_model。Multi-Image to 3D 支持多视图 texture 模型,即 Meshy 7 和 Meshy N1。每种 texture 模型都保留各自的限制;详见 Models。任务费用为其 ai_model 的仅 mesh 价格加上对应 texture 分辨率下的 Retexture 价格;详见 Pricing。不带 texture_model 的请求将保持原有方式运行。
  • 为 Text to 3D 的 refine 新增了 ai_model: "meshy-n1"。在没有 texture_image_url 的情况下,Meshy N1 会使用 Meshy 7.1 或 latest preview 所存储的参考图像进行 texture 贴图。其他 preview 则需要提供 texture_image_url。使用 Meshy N1 进行 refine 需消耗 10 积分。

Nov 2

  • 为 Retexture API 新增了 ai_model: "meshy-n1"。Meshy N1 可根据一到四张参考图生成 2K 基础色 texture。当图片数量超过一张时,第一张为正视图,其余图片的顺序与 Meshy 7 一样无关紧要。它不接受文本 prompt,不生成 PBR 贴图或 4K、8K texture,并可为最多 7,999,999 面的 3D 模型生成 texture。一个任务花费 10 积分,与 2K Retexture 相同;详见 Pricing。latest 目前仍指向 Meshy 7。

2026年10月

Oct 30

  • Text to 3D 和 Image to 3D 上的部分 Meshy T1 请求(model_type: "lowpoly" 或 ai_model: "meshy-t1")现在运行在 Smart Topology 上,其余的则返回 400。model_type: "smart-topology" 配合 ai_model: "meshy-t2.5" 取代了 T1。从 2026 年 11 月 30 日起,每个 T1 请求都将返回 400。Deprecations 列出了哪些请求仍可运行。
  • Auto Split API 新增了一个可选参数 keep_texture。设置 keep_texture: true 后,带贴图模型的每个部件都会保留 texture,任务会在 texture_urls 中返回贴图,并附带一个包含 OBJ 的 mtl 文件。不设置该参数时,拆分方式与之前相同。保留贴图的拆分耗时约为原来的两倍,费用仍为 10 积分。input_task_id 现在也接受 Text to 3D 的 refine 和 Retexture 任务。

Oct 26

  • 新增 Deprecations 页面:记录了每个 3D 生成模型的生命周期(active、legacy、deprecated 或 retired)及其停用日期和推荐替代方案、每次 API 弃用的历史记录,以及仍在使用中的已弃用参数。API 页面上的停用提示横幅现已链接到此页面。

Oct 23

  • 在 Rigging 中弃用了 texture_image_url。Meshy 会使用 model_url 文件中嵌入的 texture,或输入任务自带的 texture,因此当模型已有自己的 texture 时,请不要传入该参数。如果传入该参数,该图像将成为绑定骨骼后模型的唯一 texture,并且模型会失去其 PBR 贴图。

10月21日

  • 为 Studio 和 Enterprise 团队的所有创建任务的 endpoint 新增了 X-Meshy-Metadata 请求头,Creative Lab 的 endpoint 除外。你可以使用自己的键值对(例如 user=alex@example.com,team=fab)标记任务,并在 Usage 记录的 metadata 字段中读取它们。详见 Metadata。

10月19日

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

Oct 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

  • model_url 作为 http 或 https URL 时,现在支持最大 400 MB 的文件,相比之前的 100 MB 有所提升,适用于 Retexture、Remesh、Rigging、Convert、尺寸调整、UV Unwrap、多色打印、可打印性分析以及可打印性修复。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 秒的时间(参见任务生命周期)。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 的预览进行 refine 仍然可以正常工作。
  • 现在文档中已将 .webp 列为受支持的图片输入格式,与 .jpg、.jpeg 和 .png 并列,适用于 Image to 3D、Multi-Image to 3D、影像生成影像、Retexture(image_style_url)以及 Text to 3D Refine(texture_image_url)。该格式对公开 URL 和数据 URI(data:image/webp;base64,...)均适用。现有集成不受影响,Pricing 也保持不变。
  • Get Balance 现在还会返回 monthly_credits、permanent_credits 和 monthly_resets_at,这样你就可以查看你的 balance 中有多少将在下次刷新时过期。balance 本身保持不变。

10 月 6 日

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

2026年9月

9月29日

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

9月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 积分。

9月16日

  • Auto Split API 现在接受带贴图的 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 会返回什么,可以使用开发者平台中的 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)现在在 文字生成影像 和 影像生成影像 API 中,除 1:1、16:9、9:16、3:2 和 2:3 外,还支持 4:3 和 3:4 宽高比。

Sep 14

  • 影像生成影像 API 现在接受 input_task_id,因此你可以直接从已完成的 文字生成影像 或 影像生成影像 任务进行链式调用,而无需将其输出 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 仍然只是用于显示的任务标签,不会被刻上。

Sep 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 Library:获取 Animation API 所支持的每个预设动作(action_id、名称、分类以及动态 GIF 预览),并支持搜索和分类筛选,让你可以构建自己的动作选择器,而不必查阅参考表格。该接口免费,不消耗积分。
  • 新增 Creative Lab Collapsible Fidget API:将一张照片转换为可直接打印的可折叠减压玩具,主体的轮廓会变成层层嵌套的同心环,这些环可以压平收起,也可以拉伸展开,整体一次性打印成型,无需组装。只需一次 POST 请求即可将图片直接处理为最终模型。该接口没有 prototype(原型)/build 两个阶段,也没有可调节的 geometry 参数。每个任务消耗 6 积分,返回可打印的 STL 文件,并在 Meshy 能够生成预览时附带一个用于预览的 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 请参阅 动画库参考,价格请参阅 pricing 表。

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 团队新增了用量 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

  • 扩展了 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 积分,输出 FBX)可获得最高质量,或选择 swift mode(3 积分,输出 BVH)以实现快速、经济的生成,片段时长为 2 到 10 秒。

Aug 20

  • 为多色打印 API新增了 style 参数:选择 realistic(默认)以获得符合 texture 的精确颜色,或选择 cartoon 以获得扁平、均匀的颜色区域及更小的 3MF 文件。
  • 为所有 Creative Lab 原型 endpoint 新增了 remove_background 参数:Figure、Vinyl Figure、方块小人、Keycap、Keychain、冰箱贴以及灯具。将 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 和 影像生成影像 API 中新增了 remove_background 参数。将 remove_background 设置为 true 即可获得已移除背景的透明 RGBA PNG 格式生成图像。

Aug 13

  • 在 Text to 3D API 中新增了 ai_model: "meshy-7":我们最新的 3D 生成模型,相比 Meshy 6 具有更高保真度的 geometry。它还在 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 方块小人 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 端点上新增的 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 手办 API:将一张照片转换为大头乙烯基收藏手办 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 同时使用。

2026 年 6 月

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 生成过程中会被三角化。

6月12日

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

6月5日

Jun 1

  • 新增 Creative Lab APIs:一组以产品为维度的 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月

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 时返回水密性、体积、孔洞及非流形边等指标。此功能免费,不消耗积分。
  • 全新可打印性修复 API:修复 3D 模型以提升其 FDM printability,修复非流形边、退化面、孔洞及其他 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 参数。可以直接引用已完成的 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 积分。

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 用于设置 origin 位置(bottom 或 center)。在 Remesh API 中,auto_size 与 resize_height 互斥,不可同时使用。

Mar 17


2026 年 2 月

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 贴图功能。

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 端点添加了详细的Failure Modes文档,包括常见的 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

  • 已 deprecated Text to 3D Preview API(Meshy-6)中的 art_style 参数。该参数是为 legacy 模型(Meshy-4 / Meshy-5)设计的,将在未来版本中移除。
  • 当 ai_model 为 meshy-4 时,已 deprecated 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 网格。

2025 年 12 月

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 现在会为上传的模型保留纹理。
  • Retexture API 在启用 enable_original_uv 选项时,现在会为上传的模型保留纹理。

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

September 2025

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。

August 2025

Aug 18

8月13日

  • Meshy 5 现已在 Text to 3D 和 Image to 3D(ai_model:meshy-5)中稳定可用,带来更优的质量和一致性。

2025年7月

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

  • 在 Image to 3D 和 Text to 3D Refine API 中新增了 texture_image_url 参数,让用户可以通过图片引导 texture 的生成过程。

March 2025

Mar 28

  • 在 Text to 3D 和 Image to 3D API 中新增了 latest 参数,使用户能够使用我们即将推出的高级 AI 模型,以获得更佳的生成质量。

Mar 14

  • Text to Texture API 现已支持通过 Data URI 在 model_url 参数中传入 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


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 路径仍受支持,但建议切换到新路径。

November 2024

Nov 14