Skip to main content
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 a text description. It sends a request to create a generation task, polls for the result, and downloads the final model files in GLB and OBJ formats.

Inputs

ParameterData TypeRequiredRangeDescription
modelCOMBOYes"3.0"
"3.1"
The version of the Hunyuan3D model to use. The LowPoly option is unavailable for the 3.1 model.
promptSTRINGYes-The text description of the 3D model to generate. Supports up to 1024 characters.
face_countINTYes40000 - 1500000The target number of faces for the generated 3D model. Default: 500000.
generate_typeDYNAMICCOMBOYes"Normal"
"LowPoly"
"Geometry"
The type of 3D model to generate. The available options and their associated parameters are:
- Normal: Generates a standard model. Includes a pbr parameter (default: False).
- LowPoly: Generates a low-polygon model. Includes polygon_type ("triangle" or "quadrilateral") and pbr (default: False) parameters.
- Geometry: Generates a geometry-only model.
seedINTNo0 - 2147483647A seed value for the generation. Results are non-deterministic regardless of seed. Setting a new seed controls whether the node should re-run. Default: 0.
Note: The generate_type parameter is dynamic. Selecting "LowPoly" will reveal additional inputs for polygon_type and pbr. Selecting "Normal" will reveal an input for pbr. Selecting "Geometry" will not reveal any additional inputs. Constraint: The "LowPoly" generate type cannot be used with the "3.1" model.

Outputs

Output NameData TypeDescription
model_fileSTRINGA legacy output for backward compatibility.
GLBFILE3DGLBThe generated 3D model in the GLB file format.
OBJFILE3DOBJThe generated 3D model in the OBJ file format.