TencentTextToModelNode - ComfyUI Built-in Node Documentation

Complete documentation for the TencentTextToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

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

​

输入参数

参数	数据类型	必填	范围	描述
model	COMBO	是	"3.0" "3.1"	要使用的 Hunyuan3D 模型版本。3.1 模型不支持 LowPoly 选项。
prompt	STRING	是	-	要生成的 3D 模型的文本描述。最多支持 1024 个字符。
face_count	INT	是	40000 - 1500000	生成的 3D 模型的目标面数。默认值：500000。
generate_type	DYNAMICCOMBO	是	"Normal" "LowPoly" "Geometry"	要生成的 3D 模型类型。可用选项及其关联参数如下： - Normal：生成标准模型。包含 pbr 参数（默认值：False）。 - LowPoly：生成低多边形模型。包含 polygon_type（"triangle" 或 "quadrilateral"）和 pbr（默认值：False）参数。 - 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 文件。