内置节点参考
TencentTextToModelNode - ComfyUI Built-in Node Documentation
Complete documentation for the TencentTextToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.
此节点使用腾讯 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
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本,并转换为 xueai 静态页面。内容以官方持续更新的页面为准。