Meshy：图像转模型（智能拓扑） - ComfyUI Built-in Node Documentation

此节点使用 Meshy T2.5 从参考图像生成符合目标面数的、可用于游戏的三角网格。

此节点使用 Meshy T2.5 从参考图像生成符合目标面数的、可用于游戏的三角网格。拓扑结构直接按所需多边形数量构建，而不是在生成后再进行减面，因此结果可直接用于游戏引擎，无需额外进行重拓扑处理。

输入

参数	描述	数据类型	必需	范围
`model`	用于生成的 Meshy 模型版本。	COMBO	是	`"meshy-t2.5"`
`image`	生成模型所依据的参考图像。	IMAGE	是	-
`target_polycount`	生成网格中三角形的近似数量。默认值：15000。	INT	是	100 到 30000
`should_texture`	决定是否生成纹理。`"false"` 会跳过纹理阶段并返回无纹理的网格。	DYNAMIC\_COMBO	是	`"true"` `"false"`
`enable_pbr`	除基础颜色外，还生成 PBR 贴图（金属度、粗糙度、法线）。仅当 `should_texture` 设为 `"true"` 时此输入才可用。默认值：`False`。	BOOLEAN	否	-
`texture_prompt`	用于引导纹理生成过程的文本提示词。最多 800 个字符。不能与 `texture_image` 同时使用。仅当 `should_texture` 设为 `"true"` 时此输入才可用。默认值：`""`（空字符串）。	STRING	否	1 到 800 个字符
`texture_image`	用于纹理生成过程的参考图像。`texture_image` 或 `texture_prompt` 同一时间只能使用其中一个。仅当 `should_texture` 设为 `"true"` 时此输入才可用。	IMAGE	否	-
`texture_resolution`	纹理分辨率。更高的分辨率可捕捉更多表面细节。仅当 `should_texture` 设为 `"true"` 时此输入才可用。	COMBO	否	`"2k"` `"4k"` `"8k"`
`pose_mode`	所生成角色的姿势。空字符串表示不指定特定姿势。这是一个高级设置。默认值：`""`（空字符串）。	COMBO	是	`""` `"A-pose"` `"T-pose"`
`seed`	种子控制节点是否应重新运行；无论种子如何，结果都是不确定的。默认值：42。	INT	是	0 到 2147483647

注意： enable_pbr、texture_prompt、texture_image 和 texture_resolution 输入仅在 should_texture 设为 "true" 时可用。

约束条件：

target_polycount 是网格构建所依据的三角形数量，而不是在生成后施加的限制。
当 should_texture 设为 "true" 时，texture_prompt 和 texture_image 不能同时使用。如果两者都提供，节点将抛出错误。
texture_prompt 的最大长度为 800 个字符。

输出

输出名称	描述	数据类型
`meshy_task_id`	Meshy API 任务的唯一标识符。	MESHY\_TASK\_ID
`GLB`	生成的 GLB 格式 3D 模型。	FILE3DGLB
`FBX`	生成的 FBX 格式 3D 模型。	FILE3DFBX

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

Source fingerprint (SHA-256): e78034a591825ec6e105df1942cf501e882ac780cc2584bfa04b424ecc34a02e