> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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"`<br />`"false"`                 |
| `topology`         | 重新网格化输出的目标多边形类型。此参数仅在 `should_remesh` 设置为 `"true"` 时可用且必填。                                           | COMBO   | 否    | `"triangle"`<br />`"quad"`              |
| `target_polycount` | 重新网格化模型的目标多边形数量（默认值：300000）。此参数仅在 `should_remesh` 设置为 `"true"` 时可用。                                  | INT     | 否    | 100 至 300000                            |
| `symmetry_mode`    | 控制是否对生成的模型应用对称性。                                                                                     | COMBO   | 是    | `"auto"`<br />`"on"`<br />`"off"`       |
| `should_texture`   | 决定是否生成纹理。设置为 `"false"` 会跳过纹理阶段，返回无纹理的网格。                                                             | COMBO   | 是    | `"true"`<br />`"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   | 是    | `""`（空）<br />`"A-pose"`<br />`"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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshyMultiImageToModelNode/zh.md)

***

**Source fingerprint (SHA-256):** `e6f75f50645c8b2cf5ebbe037edb077ef1eb0ea1baf67c581d60ac0033686d00`