文档 /
节点说明 /
Hunyuan3D：文本转模型（专业版）
Hunyuan3D：文本转模型（专业版）
此节点使用腾讯 Hunyuan3D Pro API 从文本描述生成 3D 模型。
节点说明
TencentTextToModelNode 更新于 2026-11-12
Hunyuan3D：文本转模型（专业版） - ComfyUI Built-in Node Documentation
此节点使用腾讯 Hunyuan3D Pro API 从文本描述生成 3D 模型。
此节点使用腾讯 Hunyuan3D Pro API 从文本描述生成 3D 模型。它会发送请求创建生成任务，轮询结果，并下载最终的 GLB 和 OBJ 格式模型文件。
输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
模型 | 要使用的 Hunyuan3D 模型版本。3.1 模型不支持 LowPoly 选项。 | COMBO | 是 | "3.0" "3.1" |
提示词 | 要生成的 3D 模型的文本描述。最多支持 1024 个字符。 | STRING | 是 | - |
面数 | 生成 3D 模型的目标面数。默认值：500000。 | INT | 是 | 3000 - 1500000 |
生成类型 | 要生成的 3D 模型类型。可用选项及其关联参数如下： - Normal：生成标准模型。包含 pbr 参数（默认值：False）。 - LowPoly：生成低多边形模型。包含 polygon_type（"triangle" 或 "quadrilateral"）和 pbr（默认值：False）参数。 - Geometry：生成仅几何体模型。 | DYNAMICCOMBO | 是 | "Normal" "LowPoly" "Geometry" |
种子 | 生成的种子值。无论种子如何，结果均非确定性。设置新种子可控制节点是否应重新运行。默认值：0。 | INT | 否 | 0 - 2147483647 |
注意： generate_type 参数是动态的。选择 "LowPoly" 将显示 polygon_type 和 pbr 的额外输入。选择 "Normal" 将显示 pbr 的输入。选择 "Geometry" 不会显示任何额外输入。
约束： "LowPoly" 生成类型不能与 "3.1" 模型一起使用。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
模型文件 | 用于向后兼容的旧版输出。 | STRING |
GLB | 以 GLB 文件格式生成的 3D 模型。 | FILE3DGLB |
OBJ | 以 OBJ 文件格式生成的 3D 模型。 | FILE3DOBJ |
texture_image | 从生成的 OBJ 文件中提取的纹理图像（如有）。 | IMAGE |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): e35f5165941cc7761639dd72e78141326d37d5e169be9a0e326afcbcdc572b7d