> ## 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.

# MeshyImageToModelSmartTopologyNode - ComfyUI Built-in Node Documentation

> 此节点使用 Meshy T2.5 从参考图像生成符合目标面数的、可用于游戏的三角网格。

此节点使用 Meshy T2.5 从参考图像生成符合目标面数的、可用于游戏的三角网格。拓扑结构直接按所需多边形数量构建，而不是在生成后再进行减面，因此结果可直接用于游戏引擎，无需额外进行重拓扑处理。

## 输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `model` | 用于生成的 Meshy 模型版本。 | COMBO | 是 | `"meshy-t2.5"` |
| `image` | 生成模型所依据的参考图像。 | IMAGE | 是 | - |
| `target_polycount` | 生成网格中三角形的近似数量。默认值：15000。 | INT | 是 | 100 到 30000 |
| `should_texture` | 决定是否生成纹理。`"false"` 会跳过纹理阶段并返回无纹理的网格。 | DYNAMIC\_COMBO | 是 | `"true"` `"false"` |
| `enable_pbr` | 除基础颜色外，还生成 PBR 贴图（金属度、粗糙度、法线）。仅当 `should_texture` 设为 `"true"` 时此输入才可用。默认值：`False`。 | BOOLEAN | 否 | - |
| `texture_prompt` | 用于引导纹理生成过程的文本提示词。最多 800 个字符。不能与 `texture_image` 同时使用。仅当 `should_texture` 设为 `"true"` 时此输入才可用。默认值：`""`（空字符串）。 | STRING | 否 | 1 到 800 个字符 |
| `texture_image` | 用于纹理生成过程的参考图像。`texture_image` 或 `texture_prompt` 同一时间只能使用其中一个。仅当 `should_texture` 设为 `"true"` 时此输入才可用。 | IMAGE | 否 | - |
| `texture_resolution` | 纹理分辨率。更高的分辨率可捕捉更多表面细节。仅当 `should_texture` 设为 `"true"` 时此输入才可用。 | COMBO | 否 | `"2k"` `"4k"` `"8k"` |
| `pose_mode` | 所生成角色的姿势。空字符串表示不指定特定姿势。这是一个高级设置。默认值：`""`（空字符串）。 | COMBO | 是 | `""` `"A-pose"` `"T-pose"` |
| `seed` | 种子控制节点是否应重新运行；无论种子如何，结果都是不确定的。默认值：42。 | INT | 是 | 0 到 2147483647 |

**注意：** `enable_pbr`、`texture_prompt`、`texture_image` 和 `texture_resolution` 输入仅在 `should_texture` 设为 `"true"` 时可用。

**约束条件：**

* `target_polycount` 是网格构建所依据的三角形数量，而不是在生成后施加的限制。
* 当 `should_texture` 设为 `"true"` 时，`texture_prompt` 和 `texture_image` 不能同时使用。如果两者都提供，节点将抛出错误。
* `texture_prompt` 的最大长度为 800 个字符。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `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/MeshyImageToModelSmartTopologyNode/zh.md)

***

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.