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

## 输入

| 参数 | 描述 | 数据类型 | 是否必填 | 范围 |
| --- | --- | --- | --- | --- |
| `model` | 指定用于生成的 AI 模型版本。 | COMBO | 是 | `"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` | 当 `should_texture` 为 `"true"` 时，此选项会在基础颜色之外生成 PBR 贴图（金属度、粗糙度、法线）。默认值为 `False`。 | BOOLEAN | 否* | - |
| `texture_prompt` | 用于引导纹理生成过程的文本提示（最多 600 个字符）。此输入仅在 `should_texture` 设置为 `"true"` 时可用。不能与 `texture_image` 同时使用。 | STRING | 否* | - |
| `texture_image` | 用于引导纹理生成过程的图像。此输入仅在 `should_texture` 设置为 `"true"` 时可用。不能与 `texture_prompt` 同时使用。 | IMAGE | 否* | - |
| `pose_mode` | 指定生成模型的姿态模式。这是一个高级参数。 | COMBO | 是 | `""`（空）<br>`"A-pose"`<br>`"T-pose"` |
| `seed` | 生成过程的种子值。无论种子值如何，结果都是非确定性的。默认值为 0。 | INT | 是 | 0 - 2147483647 |

**参数约束说明：**

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

## 输出

| 输出名称 | 描述 | 数据类型 |
| --- | --- | --- |
| `meshy_task_id` | 生成的 GLB 模型的文件名。（为保持向后兼容性而保留）。 | STRING |
| `GLB` | Meshy API 任务的唯一标识符，可用于参考或故障排除。 | MESHY_TASK_ID |
| `FBX` | 以 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):** `134d9250d8b447bbbd2905f827e81b67f491ba355ebb93d4d256324b644100a2`