TencentImageToModelNode - ComfyUI Built-in Node Documentation

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

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

此节点使用腾讯的 Hunyuan3D Pro API，根据一张或多张输入图像生成 3D 模型。它会处理图像，将其发送到 API，并以 GLB 和 OBJ 格式返回生成的 3D 模型文件。

​

输入参数

参数	数据类型	必填	取值范围	描述
model	COMBO	是	"3.0" "3.1"	要使用的 Hunyuan3D 模型版本。3.1 模型不支持 LowPoly 选项。
image	IMAGE	是	-	用于生成 3D 模型的主要输入图像。
image_left	IMAGE	否	-	用于多视角生成的可选图像，展示物体左侧。
image_right	IMAGE	否	-	用于多视角生成的可选图像，展示物体右侧。
image_back	IMAGE	否	-	用于多视角生成的可选图像，展示物体背面。
face_count	INT	是	40000 - 1500000	生成的 3D 模型的目标面数（默认值：500000）。
generate_type	DYNAMICCOMBO	是	"Normal" "LowPoly" "Geometry"	要生成的 3D 模型类型。选择某个选项会显示其相关的附加参数。
generate_type.pbr	BOOLEAN	否	-	启用基于物理的渲染（PBR）材质生成。此参数仅在 generate_type 设置为 “Normal” 或 “LowPoly” 时可见（默认值：False）。
generate_type.polygon_type	COMBO	否	"triangle" "quadrilateral"	用于网格的多边形类型。此参数仅在 generate_type 设置为 “LowPoly” 时可见。
seed	INT	是	0 - 2147483647	生成过程的种子值。种子控制节点是否应重新运行；无论种子如何，结果都是非确定性的（默认值：0）。

注意： 所有输入图像的最小宽度和高度必须为 128 像素。

​

输出参数

输出名称	数据类型	描述
model_file	STRING	用于向后兼容的遗留输出。
GLB	FILE3DGLB	生成的 3D 模型，格式为 GLB（二进制 GL 传输格式）文件。
OBJ	FILE3DOBJ	生成的 3D 模型，格式为 OBJ（Wavefront）文件。