更新日志
查看 Meshy API 及插件的所有最新功能和更新。
2026年9月
9月18日
- 为 Image to 3D、
Multi-Image to 3D 和
Text to 3D 新增了
meshy-7.1作为ai_model取值:参数和 credit 消耗与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 个 credits。
Sep 16
- Auto Split API 现在接受带纹理的
input_task_id。此前会以400拒绝该请求,这意味着必须先用should_texture: false再生成一次相同的 mesh 才能进行拆分。请注意拆分所返回的内容:它会切割 geometry 并重建每个部件的表面,因此输入的 texture 不会被保留,结果是一个未上色的模型,每个部件只呈现单一纯色——这一点在此前的每次拆分中都是如此,并未改变。 meshy-5已停用。它不再是 Text to 3D、Image to 3D、Multi-Image to 3D 或 Retexture 的可用ai_model值。如果你的集成中发送了ai_model: "meshy-5",请改用meshy-6-lite——它接受相同的参数,费用也相同。
9月15日
- 在 文字生成影像 与 影像生成影像 API 的
ai_model文档取值中新增了gpt-image-2-5-flare与gpt-image-2-5-sunburst。这些是 OpenAI GPT Image 2.5 系列,定价与gpt-image-2相同(文字生成影像:9 credits;影像生成影像:12 credits)。 - 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—— 可以直接从一个已完成的文字生成影像或影像生成影像任务中继续,而无需将其输出 URL 复制到reference_image_urls中。
Sep 11
- 行为变更:对已处于
IN_PROGRESS状态的任务执行DELETE现在会被拒绝,并返回409 Conflict,任务将继续运行。此前该操作会返回200 OK,停止工作进程并丢弃结果——同时仍保留 credits,因为只有PENDING状态的任务才可退还,所以这样的调用会让你既损失了模型运算又损失了 credits,而响应中却没有任何提示。如果你的集成是通过删除任务来取消任务的,请注意:工作进程已经开始处理的任务无法取消——需等待任务变为SUCCEEDED、FAILED或CANCELED状态后再删除。PENDING状态的任务仍会像之前一样被删除并退还 credits,终止状态的任务也仍会被删除。此变更适用于/openapi下的所有任务系列。参见 Errors。 - 在 Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture API 的
ai_model文档取值中新增了meshy-6-lite。它是meshy-5的后继版本:参数相同,credit 消耗相同(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 credits。
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 credits)将照片像素化为像素艺术图像 —— 通过传入type为person或other来选择像素化风格 —— 而POST /build(30 credits)会将其采样到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、名称、分类以及动图预览——并支持搜索和分类筛选,方便你自行构建动作选择器,而无需查阅参考表格。免费,不消耗 credits。 - 新增 Creative Lab 可折叠指尖玩具 API:将一张照片转换为可原地打印的可折叠指尖玩具,主体的轮廓会变成层层嵌套的同心环,可压平收缩、也可拉伸展开,一体成型打印,无需组装。单次
POST请求即可将图片直接生成最终模型——没有 prototype/build 两阶段,也没有可调节的 geometry 参数。每个任务消耗 6 credits,会同时返回可用于打印的 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 credits,build 为 6 credits(此前分别为 6 和 30)。prototype 的text参数已被移除——现在需要提供image_url。
Sep 2
- Animation API 现在接受
action_ids参数——可在一次请求中为已绑定骨骼(rig)的角色应用最多 10 个预设动作,并获得一个包含每个动作对应动画片段的单一文件,可直接在游戏引擎中的状态机中驱动使用。片段会按照你列出的顺序排列,并携带该动画在库中的名称。每个动作花费 3 credits,且post_process会应用于合并后的文件。可用的 id 请参见 动画库 Reference,费用请参见 pricing 表。
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。
August 2026
Aug 28
- 为 Studio 和 Enterprise 团队新增了 Usage API:以编程方式导出历史 API 任务使用情况——包括 endpoint、状态、时间戳、执行每个任务的 API key,以及
consumed_credits——并支持标准分页以及按时间范围、endpoint 和状态进行筛选,便于成本跟踪和财务系统使用。
Aug 26
- Animation API 现已支持
motion_task_id——可将通过 Text to Motion API 生成的动作片段应用到你的已绑定双足角色(rig)上,作为预设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:可根据自然语言描述生成角色动作片段,无需角色模型。选择
primemode(10 credits,输出 FBX)以获得最高质量,或选择swiftmode(3 credits,输出 BVH)以实现快速、经济的生成,片段时长为 2-10 秒。
Aug 20
- 为多色打印 API新增了
style参数:选择realistic(默认)以获得贴合 texture 的色彩效果,或选择cartoon以获得平面、统一的色彩区域并生成更小的 3MF。 - 为每个 Creative Lab prototype endpoint 新增了
remove_background参数 —— Figure、Vinyl Figure、Brick Figure、Keycap、Keychain、Fridge Magnet 以及灯具。设置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 credits 的代价获得更精细的表面细节。若要使用 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 credits;详见 Pricing。现有的model_type: "lowpoly"现已被 deprecated,但出于向后兼容考虑仍会继续提供服务。
Aug 12
- 在 Image to 3D API 中新增了
ai_model: "meshy-7":这是我们最新的 3D 生成模型,geometry 保真度高于 Meshy 6。它还引入了ultra_mode参数,可启用 Ultra 生成以获得更精细的表面细节。 - 在 Multi-Image to 3D API 中新增了
ai_model: "meshy-7":这是 Meshy 的多视图生成模型,会同时依据你所有的输入视图进行建模,并据此驱动纹理生成。 - 在 Retexture API 中新增了
ai_model: "meshy-7":这是我们最新的纹理生成模型,表面细节更清晰,PBR 材质效果也优于 Meshy 6。它还引入了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 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
- 我们现在通过 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 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设置面数。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 套餐。
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
- 为 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。每款产品均遵循
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 和 尺寸调整功能现已作为独立的 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互斥。
5 月 11 日
- 弃用了 Text to 3D、Image to 3D 和 Multi-Image to 3D 端点上的
symmetry_mode参数。该参数不再影响输出结果。
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 的 credit 消耗情况请参见 Pricing。
4月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
- 在 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 endpoint 添加了
decimation_mode参数。用于设置自适应减面 polycount 级别:1(超高)、2(高)、3(中)或4(低)。
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:Convert 将 3D 模型转换为多色 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 端点新增了
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。
1月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 网格。
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
- 在 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 credits,该折扣将持续至 2025 年 9 月 30 日。折扣期结束后,Meshy-6-preview 任务的费用将恢复至正常的 20 credits。
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
2025 年 8 月
Aug 18
- 为 Text to 3D Preview、Image to 3D 和 Multi-Image to 3D API 新增了可选参数
is_a_t_pose,用于生成 A/T 姿势的模型。
Aug 13
- Meshy 5 现已针对 Text to 3D 和 Image to 3D(
ai_model:meshy-5)稳定发布,带来更出色的质量和一致性。
July 2025
Jul 31
- 通过
enable_pbr参数,为最新的meshy-5模型在 Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture endpoint 中支持 PBR texture 贴图。
2025年6月
Jun 25
- 新增 Retexture API,允许用户基于 Meshy 最新的基础 AI 模型对 3D 模型进行重新贴图。
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 现已支持在
model_url参数中通过 Data URI 传入 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日
- 推出了自动绑定与 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 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
- 在 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,允许用户查询其 credit 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 编码的图片。