MeshyImageToModelNode - ComfyUI Built-in Node Documentation

Complete documentation for the MeshyImageToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

Meshy: Image to Model 节点使用 Meshy API 从单张输入图像生成 3D 模型。它会将您的图像上传，提交处理任务，并返回生成的 3D 模型文件（GLB 和 FBX）以及用于参考的任务 ID。

​

输入参数

参数	数据类型	必填	范围	描述
model	COMBO	是	"latest"	指定用于生成的 AI 模型版本。
image	IMAGE	是	-	要转换为 3D 模型的输入图像。
should_remesh	DYNAMIC COMBO	是	"true" "false"	确定是否对生成的网格进行处理。当设置为 "false" 时，节点将返回未经处理的三角网格。
topology	COMBO	否*	"triangle" "quad"	重新网格化模型的目标多边形拓扑。此输入仅在 should_remesh 设置为 "true" 时可用且必需。
target_polycount	INT	否*	100 - 300000	重新网格化模型的目标多边形数量。此输入仅在 should_remesh 设置为 "true" 时可用且必需。默认值为 300000。
symmetry_mode	COMBO	是	"auto" "on" "off"	控制应用于生成的 3D 模型的对称性。
should_texture	DYNAMIC COMBO	是	"true" "false"	确定是否为模型生成纹理。将其设置为 "false" 将跳过纹理阶段，并返回一个没有纹理的网格。
enable_pbr	BOOLEAN	否*	-	当 should_texture 为 "true" 时，此选项会生成 PBR 贴图（金属度、粗糙度、法线）以及基础颜色。默认值为 False。
texture_prompt	STRING	否*	-	用于指导纹理生成过程的文本提示（最多 600 个字符）。此输入仅在 should_texture 设置为 "true" 时可用。不能与 texture_image 同时使用。
texture_image	IMAGE	否*	-	用于指导纹理生成过程的图像。此输入仅在 should_texture 设置为 "true" 时可用。不能与 texture_prompt 同时使用。
pose_mode	COMBO	是	"" "A-pose" "T-pose"	指定生成模型的姿态模式。
seed	INT	是	0 - 2147483647	生成过程的种子值。无论种子值如何，结果都是非确定性的。默认值为 0。

关于参数约束的说明：

• topology 和 target_polycount 输入仅在 should_remesh 设置为 "true" 时必需。
• enable_pbr、texture_prompt 和 texture_image 输入仅在 should_texture 设置为 "true" 时可用。
• 不能同时使用 texture_prompt 和 texture_image。如果在 should_texture 为 "true" 时同时提供了两者，节点将引发错误。

​

输出

输出名称	数据类型	描述
model_file	STRING	生成的 GLB 模型的文件名。（为向后兼容而保留）。
meshy_task_id	MESHY_TASK_ID	Meshy API 任务的唯一标识符，可用于参考或故障排除。
GLB	FILE3DGLB	生成的 GLB 文件格式的 3D 模型。
FBX	FILE3DFBX	生成的 FBX 文件格式的 3D 模型。