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 |
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