更新日志
查看 Meshy API 和插件的所有最新功能与更新。
更喜欢实时动态?最新条目也会显示在开发者平台概览页面上。
2026年11月
Nov 18
- 在 Rigging 中新增了四足动物 rigging 功能。发送
animation_type: "quadruped"即可为四足动物添加 rig。该 rig 自带行走和奔跑两种 Animation。 - Animation 可通过
action_id或action_ids将quadruped类型的 Animation 应用到四足动物 rig 上。任何quadrupedAnimation 都适用于任意四足动物 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 或latestpreview 所存储的参考图像进行 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或httpsURL 时,现在支持最大 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:无需角色模型,即可根据自然语言描述生成角色动作片段。选择
primemode(10 积分,输出 FBX)可获得最高质量,或选择swiftmode(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日
- 为 Image to 3D、Multi-Image to 3D、Text to 3D、Retexture、Remesh 和 Repair Printability API 新增了可选
alpha_thumbnail参数。设为true时,任务会额外渲染一个透明背景(RGBA)版本的预览图,并通过新的alpha_thumbnail_url响应字段返回。现有的thumbnail_url保持不变。默认值为false。
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 日
- 在 Text to 3D、Image to 3D 和 Multi-Image to 3D endpoint 上将
symmetry_mode参数标记为 deprecated。该参数不再影响输出结果。
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
- 在 Image to 3D、Multi-Image to 3D、Text to 3D Refine 和 Retexture 端点中新增了
hd_texture参数。启用后,基础颜色 texture 将以 4K(4096×4096)分辨率生成,以获得更高的细节。仅meshy-6和latest支持此参数。默认值为false。 - 当
enable_pbr为true时返回的 PBR 包,现在在 Image to 3D、Multi-Image to 3D、Text to 3D Refine 和 Retexture 的meshy-6和latest任务中,在texture_urls下新增了emission贴图。无需更改请求即可生效。
Apr 14
- 为 Image to 3D、Multi-Image to 3D、Text to 3D Preview 和 Remesh 端点新增了
decimation_mode参数。用于设置自适应简化的 polycount 级别:1(超高)、2(高)、3(中)或4(低)。
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
- 为 Image to 3D、Multi-Image to 3D、Text to 3D 和 Retexture endpoint 新增了可选的
target_formats参数。可指定要生成的 3D 格式(例如["glb", "fbx"]),以缩短任务完成时间。
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
- Text to 3D (Preview) 和 Image to 3D API 中
ai_model的latest选项现在指向 Meshy 6。
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
- 为 Text to 3D Preview、Image to 3D 和 Multi-Image to 3D API 新增了
pose_mode参数。该参数接受a-pose、t-pose或空字符串(默认值)。is_a_t_pose参数现已 deprecated,由pose_mode取代。
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-voxelAPI
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
- 更新了 Text to 3D 和 Image to 3D 的 API 定价,以反映 Meshy 6 与其他模型之间的不同费用。
Sep 16
- 在 Image to 3D API 的
ai_model中新增了latest选项,用于使用 Meshy 6 Preview。
Sep 4
August 2025
Aug 18
- 为 Text to 3D Preview、Image to 3D 和 Multi-Image to 3D API 新增了可选的
is_a_t_pose参数,用于生成 A/T 姿势的模型。
8月13日
- Meshy 5 现已在 Text to 3D 和 Image to 3D(
ai_model:meshy-5)中稳定可用,带来更优的质量和一致性。
2025年7月
7月31日
- 通过
enable_pbr参数,在最新的meshy-5模型中为 Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture 端点提供了 API 中的 PBR texture 贴图支持。
2025年6月
Jun 25
- 新增 Retexture API,用户可基于 Meshy 最新的基础 AI 模型对 3D 模型进行 Retexture。
Jun 19
- 为 Text to 3D、Image to 3D、Remesh、Rigging 和 Animation 新增了删除 API。
- 在 Text to 3D Refine API 中新增了
ai_model参数。
Jun 17
- 新增了 Webhooks 相关文档。
Jun 10
- Remesh API 现已支持通过 Data URI 在
model_url参数中传入 base64 编码的 GLB 格式模型。
May 2025
May 20
- 为 Text to 3D Preview、Text to 3D Refine、Image to 3D 和 Multi-Image to 3D API 新增了可选的
moderation参数。启用后,系统会在生成前自动对输入内容进行潜在有害内容的审查。
5月15日
- 推出了自动绑定与动画(Auto-rigging & Animation)API,使用户能够自动为 3D 模型绑定骨骼并添加动画。了解更多关于 Rigging 的信息 以及 Animation。
2025年4月
4月29日
- 推出了 Multi-Image to 3D API,支持使用
meshy-5AI 模型根据 1 到 4 张输入图像生成 3D 模型。 - 为 Text to 3D 和 Image to 3D API 新增了
meshy-5AI 模型选项。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
- 为 Text to 3D、Image to 3D、Remesh 和 Text to Texture API 添加了用于列出任务的 endpoint。
Jan 14
- 弃用了由 Meshy-3 AI 模型驱动的 legacy Text to 3D 和 Image to 3D API。
Jan 07
- 为 Text to 3D Preview 和 Image to 3D API 添加了
symmetry_mode参数,支持可配置的 symmetry 设置。
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
- 为 Image to 3D 和 Text to 3D Refine API 添加了
enable_pbr参数。 - 为 Image to 3D API 添加了
should_texture参数。 - 当使用
meshy-4AI 模型时,弃用了 Text to 3D Preview API 中art_style参数的pbr选项。 - 弃用了 Text to 3D Preview API 中
art_style参数的low-poly选项。
Dec 5
- 新增 Get Balance API,让用户可以查询自己的积分 balance。
- 为 Image to 3D 和 Text to 3D Preview API 新增了
should_remesh参数。
Dec 3
- 外部 API 现已使用
/openapi前缀。Legacy 路径仍受支持,但建议切换到新路径。
November 2024
Nov 14
- Image to 3D API 现已支持 base64 编码的图片。