文档 /
节点说明 /
Meshy:多图像转模型
Meshy:多图像转模型
此节点使用 Meshy API 从多张输入图像生成 3D 模型。它会上传提供的图像,提交处理任务,并返回生成的 3D 模型文件(GLB 和 FBX)以及供参考的任务 ID。
节点说明
MeshyMultiImageToModelNode 更新于 2026-11-12
Meshy:多图像转模型 - ComfyUI Built-in Node Documentation
此节点使用 Meshy API 从多张输入图像生成 3D 模型。它会上传提供的图像,提交处理任务,并返回生成的 3D 模型文件(GLB 和 FBX)以及供参考的任务 ID。
此节点使用 Meshy API 从多张输入图像生成 3D 模型。它会上传提供的图像,提交处理任务,并返回生成的 3D 模型文件(GLB 和 FBX)以及供参考的任务 ID。
输入
通用输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
model | 指定要使用的 AI 模型版本。 | COMBO | 是 | "meshy-7.1" "meshy-7" "meshy-6" "latest" |
should_remesh | 决定是否处理生成的网格。设为 "false" 时,节点返回未经处理的三角网格。设为 "true" 时,显示下方的重新网格化设置。 | DYNAMIC\_COMBO | 是 | "true" "false" |
symmetry_mode | 控制是否对生成的模型应用对称。 | COMBO | 是 | "auto" "on" "off" |
should_texture | 决定是否生成纹理。设为 "false" 会跳过纹理阶段并返回不带纹理的网格。设为 "true" 时,显示下方的纹理设置。 | DYNAMIC\_COMBO | 是 | "true" "false" |
pose_mode | 指定生成模型的姿态模式。 | COMBO | 是 | ""(空) "A-pose" "T-pose" |
seed | 种子控制节点是否重新运行;无论种子如何,结果都是非确定性的。(默认值:0) | INT | 是 | 0 到 2147483647 |
ultra_mode | 运行额外的细化处理,以 2048³ 获得具有更精细表面细节的高保真几何体。需要 "meshy-7.1"、"meshy-7" 或 "latest" 模型(默认:False)。 | BOOLEAN | 否 | True False |
重新网格化设置(当 should_remesh 为 "true" 时可见)
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
topology | 重新网格化输出的目标多边形类型。 | COMBO | 否 | "triangle" "quad" |
target_polycount | 重新网格化模型的目标多边形数量(默认值:300000)。 | INT | 否 | 100 到 300000 |
纹理设置(当 should_texture 为 "true" 时可见)
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
enable_pbr | 在基础颜色之外,同时生成 PBR 贴图(金属度、粗糙度、法线)。(默认值:False) | BOOLEAN | 否 | True / False |
texture_prompt | 提供文本提示以引导纹理生成过程。最多 600 个字符。不能与 texture_image 同时使用。(默认值:空) | STRING | 否 | 最多 600 个字符 |
texture_image | texture_image 和 texture_prompt 只能同时使用其中一个。 | IMAGE | 否 | - |
texture_resolution | 基础颜色纹理分辨率。更高的分辨率能够捕捉更多表面细节。 | COMBO | 否 | "2k" "4k" "8k" |
图像输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
images | 可增长插槽:连接 2 到 4 张输入图像(image_1、image_2、image_3、image_4)。这些图像用于生成 3D 模型。 | IMAGE | 是 | 2 到 4 张图像 |
备注
- 你必须为
images输入提供 2 到 4 张图像。 topology和target_polycount参数仅在should_remesh设为"true"时生效。enable_pbr、texture_prompt、texture_image和texture_resolution参数仅在should_texture设为"true"时生效。texture_prompt和texture_image互斥;你不能同时使用两者。texture_prompt限制为 600 个字符。seed值不会使结果变得确定;更改它只会让节点重新运行生成任务。ultra_mode需要"meshy-7.1"、"meshy-7"或"latest"模型;使用其他模型会引发错误。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
模型文件 | 生成的 GLB 模型的文件名。此输出仅用于向后兼容。 | STRING |
meshy_task_id | Meshy API 任务的唯一标识符。 | MESHY\_TASK\_ID |
GLB | 以 GLB 格式生成的 3D 模型。 | FILE3DGLB |
FBX | 以 FBX 格式生成的 3D 模型。 | FILE3DFBX |
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
Source fingerprint (SHA-256): 9475279c0990fc069b4fef2bf0e2e20218ca1a9591a261ce6d33a2b651782ddb