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

模型

在相同输入下比较 Meshy 的 geometry 模型和 texture 模型,为你的项目选择合适的组合。

Meshy 用两个 AI 模型生成一个 3D 模型。geometry 模型负责构建 mesh,texture 模型负责为其上色。你可以用 ai_model 选择 geometry 模型,用 texture_model 选择 texture 模型,从而根据项目需要自由组合它们。

本页的每个示例都使用相同的输入图片和默认设置生成,因此唯一的变量就是模型本身。


按项目选择

下表针对常见项目推荐了 geometry 模型和 texture 模型。

项目Geometry 模型Texture 模型原因
精细的主打 asset,例如产品渲染图或电影级道具meshy-7.1meshy-7Meshy 7.1 生成密集且细节丰富的 mesh,Meshy 7 可添加最高 8K 的 PBR 贴图。
需要绑定和动画的游戏角色meshy-t2.5meshy-n1Meshy T2.5 可按你设定的面数生成干净的三角形 mesh,Meshy N1 以较少接缝绘制干净的颜色。
游戏场景中的大量道具,或用户生成内容meshy-t2meshy-n1更快的 Smart Topology 模型,默认 4,000 面,且各部分分离。
根据 2 到 4 张照片生成真实物体在 Multi-Image to 3D 上使用 meshy-7.1meshy-7两个模型都会读取每张照片,因此侧面和背面都能与物体相符。
用于 3D 打印的模型meshy-7.1不使用,或使用 meshy-7 以彩色打印打印机打印的是 mesh。Meshy 7 能很好地分离颜色,适用于 Multi-Color Print。
以低成本生成大量草稿meshy-6-litemeshy-6-litemesh 花费 5 积分,texture 花费 10 积分。

Geometry 模型

Meshy 有两类 geometry 模型:

  • 标准模型生成密集、细节丰富、紧贴输入的 mesh。
  • Smart Topology 模型按你用 target_polycount 设定的面数生成干净的 low-poly 三角形 mesh。

标准模型

下面的对比展示了每个标准模型根据同一张图片生成的无 texture mesh。拖动任意模型即可同步旋转所有模型。按住 ⌘ 或 Ctrl 并滚动可进行缩放。

显示
视图
Meshy 7.1 3D 模型890,226 个面
Meshy 7.1meshy-7.1
Meshy 6 3D 模型678,776 个面
Meshy 6meshy-6
Meshy 6 Lite 3D 模型30,513 个面
Meshy 6 Litemeshy-6-lite默认重构网格
输入图片
输入每个模型起始的图像

下表对比了各个标准模型。

Meshy 7.1Meshy 6Meshy 6 Lite
模型 IDmeshy-7.1,或 latestmeshy-6meshy-6-lite
优势以真实 geometry 构建精细细节,形状与输入紧密对齐干净的硬表面和平滑的有机形状质量接近 Meshy 6,但耗时更短、成本仅为四分之一
示例中的面数890,226678,77630,513
仅生成 mesh 的典型耗时75 秒90 秒40 秒
更高的 geometry 分辨率geometry_resolution:2k 或 4k不支持不支持
Multi-Image to 3D支持支持支持
默认是否执行 remesh否否是,remesh 至 30,000 面
mesh 所需积分20205

以上典型耗时是 Image to 3D 的中位数。关于其他 endpoint 和选项,请参阅任务生命周期。

Meshy 7.1 会把面数分配到细节所在之处:表面细节丰富的地方面数多,平坦的地方面数少。其面数取决于输入内容,因此示例中的数字只是一次结果,而非固定值。

geometry_resolution: "4k" 能生成最精细的细节,适用于主打 asset 和特写渲染图。4k 的 mesh 面数可达约 1000 万,文件大小约 490 MB,超出了大多数 3D 打印和建模工具能良好处理的范围。4k 适用于 Image to 3D 和 Text to 3D,不适用于 Multi-Image to 3D。

Smart Topology 模型

下面的对比展示了同一张图片生成的 Smart Topology mesh,并附上 Meshy 7.1 的 mesh 作为对比。线框视图会显示出各个面。

显示
视图
Meshy T2.5 3D 模型15,721 个面
Meshy T2.5meshy-t2.5
Meshy T2 3D 模型4,353 个面
Meshy T2meshy-t2
Meshy 7.1 3D 模型890,226 个面
Meshy 7.1meshy-7.1用于对比

你可以用 target_polycount 设置面数。下图展示了 Meshy T2.5 根据同一张图片,在四种取值下生成的 mesh。

target_polycount: 1000, 1,043 个面
target_polycount: 10001,043 个面
target_polycount: 5000, 5,178 个面
target_polycount: 50005,178 个面
target_polycount: 15000, 15,721 个面
target_polycount: 1500015,721 个面
target_polycount: 30000, 30,954 个面
target_polycount: 3000030,954 个面

下表对比了 Smart Topology 模型。

Meshy T2.5Meshy T2
模型 IDmeshy-t2.5meshy-t2
优势细节更清晰,形状比 Meshy T2 更贴近输入图片生成速度更快,且模型各部分保持分离
target_polycount100 至 30000,默认 15000100 至 15000,默认 4000
示例中的面数15,7214,353
仅生成 mesh 的典型耗时15 秒4 秒
面类型仅三角形仅三角形
输入一张图片,或一段文本 prompt一张图片,或一段文本 prompt
mesh 所需积分55

Smart Topology 模型只生成三角形,因此 topology: "quad" 会返回 400。如需四边形,请使用标准模型并对其执行 remesh。参阅 Remesh。


Texture 模型

下面的对比展示了同一个 Meshy T2.5 mesh,由每个 texture 模型根据同一张图片进行上色的结果。选择“仅 Base color”可以关闭光照,查看绘制出的颜色本身,包括其中绘制的任何阴影和高光。

显示
视图
Meshy 7 3D 模型
Meshy 7meshy-7
Meshy N1 3D 模型
Meshy N1meshy-n1
Meshy 6 3D 模型
Meshy 6meshy-6
Meshy 6 Lite 3D 模型
Meshy 6 Litemeshy-6-lite
输入图片
输入每个模型起始的图像

当你发送 enable_pbr: true 时,Meshy 7、Meshy 6 和 Meshy 6 Lite 也会生成 PBR 贴图。下图是 Meshy 7 为同一模型生成的贴图。

基础颜色
基础颜色
金属度
金属度
粗糙度
粗糙度
法线
法线

下表对比了各个 texture 模型。

Meshy 7Meshy N1Meshy 6Meshy 6 Lite
最适合逼真且细节丰富的 asset、PBR 材质以及特写渲染图风格化和 low-poly 游戏 asset带有发光部分的 asset,需要 emission 贴图草稿与快速迭代
Texture 分辨率2K、4K 或 8K2K2K、4K 或 8K2K
PBR 贴图支持不支持:仅 base color支持,2K 和 4K 下含 emission 贴图支持
文本 prompt支持不支持:仅参考图片支持支持
参考图片1 到 4 张1 到 4 张1 张1 张
remove_lighting被忽略不支持支持不支持
四边形 remesh(topology: "quad")支持不支持支持支持
2K 下的典型耗时40 秒20 秒110 秒35 秒
积分10,8K 为 151010,8K 为 1510

如果请求向某个 texture 模型提出其不支持的内容,会返回 400,例如对 Meshy N1 发送文本 prompt,或对 Meshy 6 Lite 请求 4k texture。remove_lighting 会从 base color 中去除高光和阴影。

此处的积分是单独生成 texture 的价格,与 Retexture 任务相同。在 Image to 3D 和 Multi-Image to 3D 上,带 texture 的任务花费为 mesh 加上所选 texture 模型在该分辨率下的费用。参阅 Pricing。

Meshy N1 直接在模型上生成颜色,而不是混合多个 2D 视图,因此其 texture 接缝很少,颜色也会贴合 mesh。文字、图案和面部的呈现效果比 Meshy 7 更柔和,因此对于照片级真实 asset、精细细节或 PBR 贴图,请使用 Meshy 7。

Meshy 7 原生生成 8K texture,而非通过放大实现。8K 适用于特写级电影画面和主打 asset。对于实时引擎中的 asset,通常 2K 或 4K 就已足够。


多视图

发送 2 到 4 张同一物体的图片,让模型看到单张图片无法展示的侧面。请先发送正面视图,其他视图可以任意顺序排列。这些视图必须展示颜色一致的同一物体。如果视图之间不一致,结果将不可预测。

多视图 geometry

Multi-Image to 3D 会根据每张图片构建 mesh。在下面的示例中,Meshy 7.1 分别仅根据正面图片,以及根据全部三张图片生成了一个探险者模型。仅使用正面图片时,背包的背面是猜测出来的。

输入图像

正面
正面
侧面
侧面
背面
背面

每个模型的背面

输入中的背面视图
输入中的背面视图
Meshy 7.1, 来自 1 张图片
Meshy 7.1来自 1 张图片
Meshy 7.1, 来自 3 张图片
Meshy 7.1来自 3 张图片

Meshy 7.1、Meshy 6 和 Meshy 6 Lite 可接受 1 到 4 张图片。Smart Topology 模型只接受一张图片。

多视图 texture

Meshy 7 和 Meshy N1 可根据 1 到 4 张参考图片进行上色。在下面的示例中,两者分别仅根据正面图片,以及根据全部三张图片为同一个 mesh 上色。仅使用正面图片时,两者都对背包的颜色和补丁进行了猜测。使用全部三张图片时,两者都与背面视图相匹配。

每个模型的背面

Meshy 7, 1 张参考图片
Meshy 71 张参考图片
Meshy 7, 3 张参考图片
Meshy 73 张参考图片
Meshy N1, 1 张参考图片
Meshy N11 张参考图片
Meshy N1, 3 张参考图片
Meshy N13 张参考图片

要发送多张参考图片,请使用以下方式之一:

Meshy 6 和 Meshy 6 Lite 只接受一张参考图片,因此 Multi-Image to 3D 上的 texture_model 只能取 meshy-7 或 meshy-n1。


每种组合

下方网格展示了在三种输入下,每一对 geometry 模型和 texture 模型的组合结果。选择某一组合即可查看其结果。“推荐”标记了 Meshy 为每个 geometry 模型推荐的组合,与按项目选择中的内容一致。

输入
输入图片Meshy 7Meshy N1Meshy 6Meshy 6 Lite
Meshy 7.1
Meshy 6
Meshy 6 Lite
Meshy T2.5
Meshy T2
带有 Meshy N1 texture 的 Meshy T2.5 mesh
带有 Meshy N1 texture 的 Meshy T2.5 meshmeshy-t2.5 + meshy-n1适用于此 geometry 模型的推荐组合

在请求中设置模型

下表展示了在各个 endpoint 上用于设置模型的参数。

EndpointGeometry 模型Texture 模型
Image to 3Dai_model,对于 Meshy T2.5 和 Meshy T2 需配合 model_type: "smart-topology"texture_model:meshy-7、meshy-n1 或 meshy-6-lite
Multi-Image to 3Dai_modeltexture_model:meshy-7 或 meshy-n1
Text to 3Dpreview 任务上的 ai_modelrefine 任务上的 ai_model
Retexture无:你发送的是已有的模型ai_model

例如,以下 Image to 3D 请求使用 Meshy T2.5 生成一个游戏角色,并用 Meshy N1 为其上色:

{
  "image_url": "https://example.com/character.png",
  "model_type": "smart-topology",
  "ai_model": "meshy-t2.5",
  "target_polycount": 15000,
  "texture_model": "meshy-n1"
}

如果省略 texture_model,Meshy 会使用该 geometry 模型对应的默认 texture 模型。下表列出了这些默认值。即使 Meshy 发布新的 texture 模型,这些默认值也不会改变,因此不带 texture_model 的请求始终会得到同一类结果。

Geometry 模型默认 texture 模型
Meshy 7.1Meshy 7
Meshy 6Meshy 6
Meshy 6 LiteMeshy 6 Lite
Meshy T2.5Meshy 7
Meshy T2Meshy 7

发送默认值与省略 texture_model 效果相同。texture_model 只接受模型 ID。在 Image to 3D 上,meshy-6 仅作为 Meshy 6 的默认值可用。在 Multi-Image to 3D 上,带 texture 的请求若使用 meshy-6 或 meshy-6-lite 会返回 400。

在 Text to 3D 的 refine 任务上,ai_model 可选择 Meshy 7、Meshy N1、Meshy 6 或 Meshy 6 Lite。Meshy N1 会根据 texture_image_url,或根据 Meshy 7.1 preview 阶段所存储的参考图片进行上色。