Skip to main content
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

ParameterDescriptionData TypeRequiredRange
modelThe version of the Hunyuan3D model to use. The LowPoly option is unavailable for the 3.1 model.COMBOYes"3.0"
"3.1"
promptThe text description of the 3D model to generate. Supports up to 1024 characters.STRINGYes-
face_countThe target number of faces for the generated 3D model. Default: 500000.INTYes3000 - 1500000
generate_typeThe 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.
DYNAMICCOMBOYes"Normal"
"LowPoly"
"Geometry"
seedA 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.INTNo0 - 2147483647
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 NameDescriptionData Type
model_fileA legacy output for backward compatibility.STRING
GLBThe generated 3D model in the GLB file format.FILE3DGLB
OBJThe generated 3D model in the OBJ file format.FILE3DOBJ
texture_imageThe texture image extracted from the generated OBJ file, if 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): 2e8799d6863a0a7113d22f1637251735a217797679d7a97268910b88d9864e4a