内置节点参考
MeshyMultiImageToModelNode - ComfyUI Built-in Node Documentation
Complete documentation for the MeshyMultiImageToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.
此节点使用 Meshy API 从多张输入图像生成 3D 模型。它会上传提供的图像，提交处理任务，并返回生成的 3D 模型文件（GLB 和 FBX）以及用于参考的任务 ID。
输入
| 参数 | 描述 | 数据类型 | 是否必填 | 范围 |
|---|---|---|---|---|
model |
指定要使用的 AI 模型版本。 | COMBO | 是 | "latest" |
images |
用于生成 3D 模型的图像集。您必须提供 2 到 4 张图像。 | IMAGE | 是 | 2 至 4 张图像 |
should_remesh |
决定是否对生成的网格进行处理。设置为 "false" 时，节点返回未处理的三角网格。 |
COMBO | 是 | "true" |
"false" |
||||
topology |
重新网格化输出的目标多边形类型。此参数仅在 should_remesh 设置为 "true" 时可用且必填。 |
COMBO | 否 | "triangle" |
"quad" |
||||
target_polycount |
重新网格化模型的目标多边形数量（默认值：300000）。此参数仅在 should_remesh 设置为 "true" 时可用。 |
INT | 否 | 100 至 300000 |
symmetry_mode |
控制是否对生成的模型应用对称性。 | COMBO | 是 | "auto" |
"on" "off" | | should_texture | 决定是否生成纹理。设置为 "false" 会跳过纹理阶段，返回无纹理的网格。 | COMBO | 是 | "true" "false" | | enable_pbr | 当 should_texture 为 "true" 时，此选项会在基础颜色之外生成 PBR 贴图（金属度、粗糙度、法线）（默认值：False）。 | BOOLEAN | 否 | True / False | | texture_prompt | 用于引导纹理处理过程的文本提示（最多 600 个字符）。不能与 texture_image 同时使用。此参数仅在 should_texture 设置为 "true" 时可用。 | STRING | 否 | - | | texture_image | 用于引导纹理处理过程的图像。texture_image 和 texture_prompt 只能同时使用其中一个。此参数仅在 should_texture 设置为 "true" 时可用。 | IMAGE | 否 | - | | pose_mode | 指定生成模型的姿态模式。 | COMBO | 是 | ""（空） "A-pose" "T-pose" | | seed | 生成过程的种子值（默认值：0）。无论种子如何，结果都是非确定性的，但更改种子可以触发节点重新运行。 | INT | 是 | 0 至 2147483647 |
参数约束：
- 您必须为
images输入提供 2 到 4 张图像。 topology和target_polycount参数仅在should_remesh设置为"true"时生效。enable_pbr、texture_prompt和texture_image参数仅在should_texture设置为"true"时生效。- 不能同时使用
texture_prompt和texture_image；它们是互斥的。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
模型文件 |
生成的 GLB 模型的文件名。此输出提供用于向后兼容。 | STRING |
meshy_task_id |
Meshy API 任务的唯一标识符。 | MESHY_TASK_ID |
GLB |
以 GLB 格式生成的 3D 模型。 | FILE3DGLB |
FBX |
以 FBX 格式生成的 3D 模型。 | FILE3DFBX |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): e6f75f50645c8b2cf5ebbe037edb077ef1eb0ea1baf67c581d60ac0033686d00
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。