TencentImageToModelNode - ComfyUI Built-in Node Documentation

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

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

This node uses Tencent’s Hunyuan3D Pro API to generate a 3D model from one or more input images. It processes the images, sends them to the API, and returns the generated 3D model files in GLB and OBJ formats, along with optional texture maps.

Inputs

Parameter	Data Type	Required	Range	Description
model	COMBO	Yes	"3.0" "3.1"	The version of the Hunyuan3D model to use. The LowPoly option is unavailable for the 3.1 model.
image	IMAGE	Yes	-	The primary input image used to generate the 3D model. Must be at least 128x128 pixels.
image_left	IMAGE	No	-	An optional image of the object’s left side for multi-view generation. Must be at least 128x128 pixels.
image_right	IMAGE	No	-	An optional image of the object’s right side for multi-view generation. Must be at least 128x128 pixels.
image_back	IMAGE	No	-	An optional image of the object’s back side for multi-view generation. Must be at least 128x128 pixels.
face_count	INT	Yes	3000 - 1500000	The target number of faces for the generated 3D model (default: 500000).
generate_type	DYNAMICCOMBO	Yes	"Normal" "LowPoly" "Geometry"	The type of 3D model to generate. Selecting an option reveals additional related parameters.
generate_type.pbr	BOOLEAN	No	-	Enables Physically Based Rendering (PBR) material generation. This parameter is only visible when generate_type is set to “Normal” or “LowPoly” (default: False).
generate_type.polygon_type	COMBO	No	"triangle" "quadrilateral"	The type of polygon to use for the mesh. This parameter is only visible when generate_type is set to “LowPoly”.
seed	INT	Yes	0 - 2147483647	A seed value for the generation process. Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0).

Note: All input images must have a minimum width and height of 128 pixels. Images are automatically downscaled if they exceed 4900 pixels on their longest side.

Outputs

Output Name	Data Type	Description
model_file	STRING	A legacy output for backward compatibility.
GLB	FILE3DGLB	The generated 3D model in the GLB (Binary GL Transmission Format) file format.
OBJ	FILE3DOBJ	The generated 3D model in the OBJ (Wavefront) file format.
texture_image	IMAGE	The texture image for the generated 3D model.
optional_metallic	IMAGE	The metallic map for PBR materials. Returns a black image if not available.
optional_normal	IMAGE	The normal map for PBR materials. Returns a black image if not available.
optional_roughness	IMAGE	The roughness map for PBR materials. Returns a black image if not available.

---

Source fingerprint (SHA-256): b4cb268fe3b2f5890e5460d5e69897ccc47e205b05546aea18a85ad15717f12a