MeshyImageToModelNode - ComfyUI Built-in Node Documentation - ComfyUI

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

输入

参数	描述	数据类型	必需	范围
`model`	指定用于生成的 AI 模型版本。	COMBO	是	`"meshy-7.1"` `"meshy-7"` `"meshy-6"` `"latest"`
`image`	要转换为 3D 模型的输入图像。	IMAGE	是	-
`should_remesh`	当设置为 `"false"` 时，返回未经处理的三角网格。	DYNAMIC_COMBO	是	`"true"` `"false"`
`topology`	重新网格化后模型的目标多边形拓扑。此输入仅在 `should_remesh` 设置为 `"true"` 时可用。	COMBO	否*	`"triangle"` `"quad"`
`target_polycount`	重新网格化后模型的目标多边形数量。此输入仅在 `should_remesh` 设置为 `"true"` 时可用。默认值：300000。	INT	否*	100 - 300000
`symmetry_mode`	控制应用于所生成 3D 模型的对称性。	COMBO	是	`"auto"` `"on"` `"off"`
`should_texture`	决定是否生成纹理。将其设置为 `"false"` 将跳过纹理阶段，并返回不带纹理的网格。	DYNAMIC_COMBO	是	`"true"` `"false"`
`enable_pbr`	在基础颜色之外生成 PBR 贴图（金属度、粗糙度、法线）。此输入仅在 `should_texture` 设置为 `"true"` 时可用。默认值：`False`。	BOOLEAN	否*	-
`texture_prompt`	提供文本提示以指导纹理生成过程。最多 600 个字符。不能与 `texture_image` 同时使用。此输入仅在 `should_texture` 设置为 `"true"` 时可用。默认值：空字符串。	STRING	否*	-
`texture_image`	`texture_image` 和 `texture_prompt` 同时只能使用其中一个。此输入仅在 `should_texture` 设置为 `"true"` 时可用。	IMAGE	否*	-
`texture_resolution`	基础颜色纹理分辨率。更高的分辨率可以捕捉更多表面细节。此输入仅在 `should_texture` 设置为 `"true"` 时可用。	COMBO	否*	`"2k"` `"4k"` `"8k"`
`pose_mode`	指定所生成模型的姿态模式。这是一个高级参数。	COMBO	是	`""` (empty) `"A-pose"` `"T-pose"`
`seed`	`seed` 用于控制节点是否应重新运行；结果不受 seed 影响，始终是非确定性的。默认值：0。	INT	是	0 - 2147483647
`超精细模式`	运行额外的细化过程，以获得具有更精细表面细节的高保真几何体。默认值：`False`。	BOOLEAN	是	-
`ultra_resolution`	超精细处理的分辨率：`"2k"` 以 2048³ 运行，`"4k"` 以 4096³ 运行，以获得最精细的表面细节。`"4k"` 需要 `"meshy-7.1"` 或 `"latest"` 模型。仅在启用 `ultra_mode` 时使用（默认：`"2k"`）。	COMBO	否	`"2k"` `"4k"`

参数约束说明：

topology 和 target_polycount 输入仅在 should_remesh 设置为 "true" 时可用。
enable_pbr、texture_prompt、texture_image 和 texture_resolution 输入仅在 should_texture 设置为 "true" 时可用。
当 should_texture 设置为 "true" 时，texture_prompt 和 texture_image 不能同时使用。如果同时提供，节点将报错。
texture_prompt 最大长度为 600 个字符。
当启用 ultra_mode 时，model 参数必须设置为 "meshy-7.1"、"meshy-7" 或 "latest"；选择任何其他模型都会引发错误。使用 "meshy-7" 时，超精细处理始终以 2048³ 运行，而 "4k" 的超精细分辨率需要 "meshy-7.1" 或 "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): 38528b48c3f792a459008a52f65fae248ef1dadafb37fe4dc6b697d25bc89f4f