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

# TencentTextToModelNode - ComfyUI Built-in Node Documentation

> Complete documentation for the TencentTextToModelNode 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/TencentTextToModelNode/zh.md)

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

## 输入参数

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

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

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

## 输出

| 输出名称         | 数据类型      | 描述                    |
| ------------ | --------- | --------------------- |
| `model_file` | STRING    | 用于向后兼容的遗留输出。          |
| `GLB`        | FILE3DGLB | 生成的 3D 模型，格式为 GLB 文件。 |
| `OBJ`        | FILE3DOBJ | 生成的 3D 模型，格式为 OBJ 文件。 |