MeshyMultiImageToModelNode - ComfyUI Built-in Node Documentation - ComfyUI

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

输入

通用输入

参数	描述	数据类型	必填	范围
`model`	指定要使用的 AI 模型版本。	COMBO	是	`"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

重新网格化设置（当 `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 值不会使结果变得确定；更改它只会让节点重新运行生成任务。

输出

输出名称	描述	数据类型
`模型文件`	生成的 GLB 模型的文件名。此输出仅用于向后兼容。	STRING
`meshy_task_id`	Meshy API 任务的唯一标识符。	MESHY_TASK_ID
`GLB`	以 GLB 格式生成的 3D 模型。	FILE3DGLB
`FBX`	以 FBX 格式生成的 3D 模型。	FILE3DFBX

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

Source fingerprint (SHA-256): a8b2fc23ef8a8a4af097489c15beb3e0ed205dfdc8309afc95207d7a5616d37a