> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# MeshyMultiImageToModelNode - ComfyUI Built-in Node Documentation
> 此节点使用 Meshy API 从多张输入图像生成 3D 模型。
此节点使用 Meshy API 从多张输入图像生成 3D 模型。它会上传提供的图像，提交处理任务，并返回生成的 3D 模型文件（GLB 和 FBX）以及供参考的任务 ID。
## 输入
### 通用输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `model` | 指定要使用的 AI 模型版本。 | COMBO | 是 | `"meshy-7.1"`
`"meshy-7"`
`"meshy-6"`
`"latest"` |
| `should_remesh` | 决定是否处理生成的网格。设为 `"false"` 时，节点返回未经处理的三角网格。设为 `"true"` 时，显示下方的重新网格化设置。 | DYNAMIC\_COMBO | 是 | `"true"`
`"false"` |
| `symmetry_mode` | 控制是否对生成的模型应用对称。 | COMBO | 是 | `"auto"`
`"on"`
`"off"` |
| `should_texture` | 决定是否生成纹理。设为 `"false"` 会跳过纹理阶段并返回不带纹理的网格。设为 `"true"` 时，显示下方的纹理设置。 | DYNAMIC\_COMBO | 是 | `"true"`
`"false"` |
| `pose_mode` | 指定生成模型的姿态模式。 | COMBO | 是 | `""`（空）
`"A-pose"`
`"T-pose"` |
| `seed` | 种子控制节点是否重新运行；无论种子如何，结果都是非确定性的。（默认值：0） | INT | 是 | 0 到 2147483647 |
| `ultra_mode` | 运行额外的细化处理，以 2048³ 获得具有更精细表面细节的高保真几何体。需要 `"meshy-7.1"`、`"meshy-7"` 或 `"latest"` 模型（默认：`False`）。 | BOOLEAN | 否 | `True`
`False` |
### 重新网格化设置（当 `should_remesh` 为 `"true"` 时可见）
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `topology` | 重新网格化输出的目标多边形类型。 | COMBO | 否 | `"triangle"`
`"quad"` |
| `target_polycount` | 重新网格化模型的目标多边形数量（默认值：300000）。 | INT | 否 | 100 到 300000 |
### 纹理设置（当 `should_texture` 为 `"true"` 时可见）
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `enable_pbr` | 在基础颜色之外，同时生成 PBR 贴图（金属度、粗糙度、法线）。（默认值：False） | BOOLEAN | 否 | True / False |
| `texture_prompt` | 提供文本提示以引导纹理生成过程。最多 600 个字符。不能与 `texture_image` 同时使用。（默认值：空） | STRING | 否 | 最多 600 个字符 |
| `texture_image` | `texture_image` 和 `texture_prompt` 只能同时使用其中一个。 | IMAGE | 否 | - |
| `texture_resolution` | 基础颜色纹理分辨率。更高的分辨率能够捕捉更多表面细节。 | COMBO | 否 | `"2k"`
`"4k"`
`"8k"` |
### 图像输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `images` | 可增长插槽：连接 2 到 4 张输入图像（`image_1`、`image_2`、`image_3`、`image_4`）。这些图像用于生成 3D 模型。 | IMAGE | 是 | 2 到 4 张图像 |
**备注**
* 你必须为 `images` 输入提供 2 到 4 张图像。
* `topology` 和 `target_polycount` 参数仅在 `should_remesh` 设为 `"true"` 时生效。
* `enable_pbr`、`texture_prompt`、`texture_image` 和 `texture_resolution` 参数仅在 `should_texture` 设为 `"true"` 时生效。
* `texture_prompt` 和 `texture_image` 互斥；你不能同时使用两者。`texture_prompt` 限制为 600 个字符。
* `seed` 值不会使结果变得确定；更改它只会让节点重新运行生成任务。
* `ultra_mode` 需要 `"meshy-7.1"`、`"meshy-7"` 或 `"latest"` 模型；使用其他模型会引发错误。
## 输出
| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `模型文件` | 生成的 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):** `9475279c0990fc069b4fef2bf0e2e20218ca1a9591a261ce6d33a2b651782ddb`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.