MeshyMultiImageToModelNode - ComfyUI Built-in Node Documentation - ComfyUI

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

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

输入参数

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

参数约束：

必须为 images 输入提供 2 到 4 张图像。
topology 和 target_polycount 参数仅在 should_remesh 设置为 "true" 时生效。
enable_pbr、texture_prompt 和 texture_image 参数仅在 should_texture 设置为 "true" 时生效。
不能同时使用 texture_prompt 和 texture_image；它们是互斥的。

输出参数

输出名称	数据类型	描述
`model_file`	STRING	生成的 GLB 模型的文件名。此输出是为了向后兼容而提供的。
`meshy_task_id`	MESHY_TASK_ID	Meshy API 任务的唯一标识符。
`GLB`	FILE3DGLB	生成的 GLB 格式的 3D 模型。
`FBX`	FILE3DFBX	生成的 FBX 格式的 3D 模型。

MeshyImageToModelNode - ComfyUI Built-in Node Documentation

MeshyRefineNode - ComfyUI Built-in Node Documentation