> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MeshyImageToModelNode - ComfyUI Built-in Node Documentation

> Complete documentation for the MeshyImageToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshyImageToModelNode/zh.md)

Meshy: Image to Model 节点使用 Meshy API 从单张输入图像生成 3D 模型。它会将您的图像上传，提交处理任务，并返回生成的 3D 模型文件（GLB 和 FBX）以及用于参考的任务 ID。

## 输入参数

| 参数                 | 数据类型          | 必填  | 范围                                   | 描述                                                                                            |
| ------------------ | ------------- | --- | ------------------------------------ | --------------------------------------------------------------------------------------------- |
| `model`            | COMBO         | 是   | `"latest"`                           | 指定用于生成的 AI 模型版本。                                                                              |
| `image`            | IMAGE         | 是   | -                                    | 要转换为 3D 模型的输入图像。                                                                              |
| `should_remesh`    | DYNAMIC COMBO | 是   | `"true"`<br />`"false"`              | 确定是否对生成的网格进行处理。当设置为 `"false"` 时，节点将返回未经处理的三角网格。                                               |
| `topology`         | COMBO         | 否\* | `"triangle"`<br />`"quad"`           | 重新网格化模型的目标多边形拓扑。此输入仅在 `should_remesh` 设置为 `"true"` 时可用且必需。                                    |
| `target_polycount` | INT           | 否\* | 100 - 300000                         | 重新网格化模型的目标多边形数量。此输入仅在 `should_remesh` 设置为 `"true"` 时可用且必需。默认值为 300000。                        |
| `symmetry_mode`    | COMBO         | 是   | `"auto"`<br />`"on"`<br />`"off"`    | 控制应用于生成的 3D 模型的对称性。                                                                           |
| `should_texture`   | DYNAMIC COMBO | 是   | `"true"`<br />`"false"`              | 确定是否为模型生成纹理。将其设置为 `"false"` 将跳过纹理阶段，并返回一个没有纹理的网格。                                             |
| `enable_pbr`       | BOOLEAN       | 否\* | -                                    | 当 `should_texture` 为 `"true"` 时，此选项会生成 PBR 贴图（金属度、粗糙度、法线）以及基础颜色。默认值为 `False`。                 |
| `texture_prompt`   | STRING        | 否\* | -                                    | 用于指导纹理生成过程的文本提示（最多 600 个字符）。此输入仅在 `should_texture` 设置为 `"true"` 时可用。不能与 `texture_image` 同时使用。 |
| `texture_image`    | IMAGE         | 否\* | -                                    | 用于指导纹理生成过程的图像。此输入仅在 `should_texture` 设置为 `"true"` 时可用。不能与 `texture_prompt` 同时使用。              |
| `pose_mode`        | COMBO         | 是   | `""`<br />`"A-pose"`<br />`"T-pose"` | 指定生成模型的姿态模式。                                                                                  |
| `seed`             | INT           | 是   | 0 - 2147483647                       | 生成过程的种子值。无论种子值如何，结果都是非确定性的。默认值为 0。                                                            |

**关于参数约束的说明：**

* `topology` 和 `target_polycount` 输入仅在 `should_remesh` 设置为 `"true"` 时必需。
* `enable_pbr`、`texture_prompt` 和 `texture_image` 输入仅在 `should_texture` 设置为 `"true"` 时可用。
* 不能同时使用 `texture_prompt` 和 `texture_image`。如果在 `should_texture` 为 `"true"` 时同时提供了两者，节点将引发错误。

## 输出

| 输出名称            | 数据类型            | 描述                             |
| --------------- | --------------- | ------------------------------ |
| `model_file`    | STRING          | 生成的 GLB 模型的文件名。（为向后兼容而保留）。     |
| `meshy_task_id` | MESHY\_TASK\_ID | Meshy API 任务的唯一标识符，可用于参考或故障排除。 |
| `GLB`           | FILE3DGLB       | 生成的 GLB 文件格式的 3D 模型。           |
| `FBX`           | FILE3DFBX       | 生成的 FBX 文件格式的 3D 模型。           |