TencentImageToModelNode - ComfyUI Built-in Node Documentation

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

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

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

Source fingerprint (SHA-256): b4cb268fe3b2f5890e5460d5e69897ccc47e205b05546aea18a85ad15717f12a

​Inputs

​Outputs

Inputs

Outputs