此节点使用腾讯 Hunyuan3D Pro API 从文本描述生成 3D 模型。它会发送请求创建生成任务，轮询结果，并下载最终的 GLB 和 OBJ 格式模型文件。

## 输入

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| --- | --- | --- | --- | --- |
| `模型` | 要使用的 Hunyuan3D 模型版本。`3.1` 模型不支持 LowPoly 选项。 | COMBO | 是 | `"3.0"`<br>`"3.1"` |
| `提示词` | 要生成的 3D 模型的文本描述。最多支持 1024 个字符。 | STRING | 是 | - |
| `面数` | 生成 3D 模型的目标面数。默认值：500000。 | INT | 是 | 3000 - 1500000 |
| `生成类型` | 要生成的 3D 模型类型。可用选项及其关联参数如下：<br>- **Normal**：生成标准模型。包含 `pbr` 参数（默认值：`False`）。<br>- **LowPoly**：生成低多边形模型。包含 `polygon_type`（`"triangle"` 或 `"quadrilateral"`）和 `pbr`（默认值：`False`）参数。<br>- **Geometry**：生成仅几何体模型。 | DYNAMICCOMBO | 是 | `"Normal"`<br>`"LowPoly"`<br>`"Geometry"` |
| `种子` | 生成的种子值。无论种子如何，结果均非确定性。设置新种子可控制节点是否应重新运行。默认值：0。 | INT | 否 | 0 - 2147483647 |

**注意：** `generate_type` 参数是动态的。选择 `"LowPoly"` 将显示 `polygon_type` 和 `pbr` 的额外输入。选择 `"Normal"` 将显示 `pbr` 的输入。选择 `"Geometry"` 不会显示任何额外输入。

**约束：** `"LowPoly"` 生成类型不能与 `"3.1"` 模型一起使用。

## 输出

| 输出名称 | 描述 | 数据类型 |
| --- | --- | --- |
| `GLB` | 用于向后兼容的旧版输出。 | STRING |
| `OBJ` | 以 GLB 文件格式生成的 3D 模型。 | FILE3DGLB |
| `texture_image` | 以 OBJ 文件格式生成的 3D 模型。 | FILE3DOBJ |
| `texture_image` | 从生成的 OBJ 文件中提取的纹理图像（如有）。 | IMAGE |

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

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