ComfyPilotComfyPilot
文档 / 节点说明 / Meshy：图像转模型

Meshy：图像转模型

Mesh：Image to Model 节点使用 Meshy API，从单个输入图像生成 3D 模型。

节点说明 MeshyImageToModelNode 更新于 2026-11-12

查看官方原文

Meshy：图像转模型 - ComfyUI Built-in Node Documentation

Mesh：Image to Model 节点使用 Meshy API，从单个输入图像生成 3D 模型。

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_imagetexture_image 和 texture_prompt 同时只能使用其中一个。此输入仅在 should_texture 设置为 "true" 时可用。IMAGE否\*-
texture_resolution基础颜色纹理分辨率。更高的分辨率可以捕捉更多表面细节。此输入仅在 should_texture 设置为 "true" 时可用。COMBO否\*"2k" "4k" "8k"
pose_mode指定所生成模型的姿态模式。这是一个高级参数。COMBO是"" (empty) "A-pose" "T-pose"
seedseed 用于控制节点是否应重新运行；结果不受 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_idMeshy API 任务的唯一标识符，可用于参考或故障排查。MESHY\_TASK\_ID
GLB以 GLB 文件格式生成的 3D 模型。FILE3DGLB
FBX以 FBX 文件格式生成的 3D 模型。FILE3DFBX
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

Source fingerprint (SHA-256): 38528b48c3f792a459008a52f65fae248ef1dadafb37fe4dc6b697d25bc89f4f