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

# MeshyImageToModelNode - 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"`<br />`"meshy-6"`<br />`"latest"` |
| `image`              | 要转换为 3D 模型的输入图像。                                                                                      | IMAGE          | 是   | -                                            |
| `should_remesh`      | 当设置为 `"false"` 时，返回未经处理的三角网格。                                                                         | DYNAMIC\_COMBO | 是   | `"true"`<br />`"false"`                      |
| `topology`           | 重新网格化后模型的目标多边形拓扑。此输入仅在 `should_remesh` 设置为 `"true"` 时可用。                                              | COMBO          | 否\* | `"triangle"`<br />`"quad"`                   |
| `target_polycount`   | 重新网格化后模型的目标多边形数量。此输入仅在 `should_remesh` 设置为 `"true"` 时可用。默认值：300000。                                   | INT            | 否\* | 100 - 300000                                 |
| `symmetry_mode`      | 控制应用于所生成 3D 模型的对称性。                                                                                   | COMBO          | 是   | `"auto"`<br />`"on"`<br />`"off"`            |
| `should_texture`     | 决定是否生成纹理。将其设置为 `"false"` 将跳过纹理阶段，并返回不带纹理的网格。                                                          | DYNAMIC\_COMBO | 是   | `"true"`<br />`"false"`                      |
| `enable_pbr`         | 在基础颜色之外生成 PBR 贴图（金属度、粗糙度、法线）。此输入仅在 `should_texture` 设置为 `"true"` 时可用。默认值：`False`。                     | BOOLEAN        | 否\* | -                                            |
| `texture_prompt`     | 提供文本提示以指导纹理生成过程。最多 600 个字符。不能与 `texture_image` 同时使用。此输入仅在 `should_texture` 设置为 `"true"` 时可用。默认值：空字符串。 | STRING         | 否\* | -                                            |
| `texture_image`      | `texture_image` 和 `texture_prompt` 同时只能使用其中一个。此输入仅在 `should_texture` 设置为 `"true"` 时可用。                | IMAGE          | 否\* | -                                            |
| `texture_resolution` | 基础颜色纹理分辨率。更高的分辨率可以捕捉更多表面细节。此输入仅在 `should_texture` 设置为 `"true"` 时可用。                                   | COMBO          | 否\* | `"2k"`<br />`"4k"`<br />`"8k"`               |
| `pose_mode`          | 指定所生成模型的姿态模式。这是一个高级参数。                                                                                | COMBO          | 是   | `""` (empty)<br />`"A-pose"`<br />`"T-pose"` |
| `seed`               | `seed` 用于控制节点是否应重新运行；结果不受 seed 影响，始终是非确定性的。默认值：0。                                                     | INT            | 是   | 0 - 2147483647                               |
| `超精细模式`              | 运行额外的细化过程，以获得具有更精细表面细节的高保真几何体。默认值：`False`。                                                            | BOOLEAN        | 是   | -                                            |

**参数约束说明：**

* `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` 需要 `"meshy-7"` 或 `"latest"` 模型。如果在 `"meshy-6"` 模型上启用 `ultra_mode`，节点将报错。

## 输出

| 输出名称            | 描述                             | 数据类型            |
| --------------- | ------------------------------ | --------------- |
| `模型文件`          | 生成的 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/MeshyImageToModelNode/zh.md)

***

**Source fingerprint (SHA-256):** `689828ad52de4493e1039aecc408e18af4122d2c0e2511fd254ba0f1d56bad14`