MeshyImageToModelNode - ComfyUI Built-in Node Documentation

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

输入

参数	描述	数据类型	是否必填	范围
`model`	指定用于生成的 AI 模型版本。	COMBO	是	`"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`	当 `should_texture` 为 `"true"` 时，此选项会在基础颜色之外生成 PBR 贴图（金属度、粗糙度、法线）。默认值为 `False`。	BOOLEAN	否*	-
`texture_prompt`	用于引导纹理生成过程的文本提示（最多 600 个字符）。此输入仅在 `should_texture` 设置为 `"true"` 时可用。不能与 `texture_image` 同时使用。	STRING	否*	-
`texture_image`	用于引导纹理生成过程的图像。此输入仅在 `should_texture` 设置为 `"true"` 时可用。不能与 `texture_prompt` 同时使用。	IMAGE	否*	-
`pose_mode`	指定生成模型的姿态模式。这是一个高级参数。	COMBO	是	`""`（空） `"A-pose"` `"T-pose"`
`seed`	生成过程的种子值。无论种子值如何，结果都是非确定性的。默认值为 0。	INT	是	0 - 2147483647

参数约束说明：

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

输出

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

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

Source fingerprint (SHA-256): 134d9250d8b447bbbd2905f827e81b67f491ba355ebb93d4d256324b644100a2

​输入

​输出

输入

输出