Inputs
| Parameter | Description | Data Type | Required | Range |
|---|---|---|---|---|
model | Specifies the AI model version to use for generation. | COMBO | Yes | "latest" |
image | The input image to convert into a 3D model. | IMAGE | Yes | - |
should_remesh | Determines if the generated mesh should be processed. When set to "false", the node returns an unprocessed triangular mesh. | DYNAMIC COMBO | Yes | "true""false" |
topology | The target polygon topology for the remeshed model. This input is only available when should_remesh is set to "true". | COMBO | No* | "triangle""quad" |
target_polycount | The target number of polygons for the remeshed model. This input is only available when should_remesh is set to "true". The default value is 300000. | INT | No* | 100 - 300000 |
symmetry_mode | Controls the symmetry applied to the generated 3D model. | COMBO | Yes | "auto""on""off" |
should_texture | Determines whether textures are generated for the model. Setting it to "false" skips the texture phase and returns a mesh without textures. | DYNAMIC COMBO | Yes | "true""false" |
enable_pbr | When should_texture is "true", this option generates PBR maps (metallic, roughness, normal) in addition to the base color. The default value is False. | BOOLEAN | No* | - |
texture_prompt | A text prompt to guide the texturing process (maximum 600 characters). This input is only available when should_texture is "true". It cannot be used at the same time as texture_image. | STRING | No* | - |
texture_image | An image to guide the texturing process. This input is only available when should_texture is "true". It cannot be used at the same time as texture_prompt. | IMAGE | No* | - |
pose_mode | Specifies the pose mode for the generated model. This is an advanced parameter. | COMBO | Yes | "" (empty)"A-pose""T-pose" |
seed | A seed value for the generation process. The results are non-deterministic regardless of the seed value. The default value is 0. | INT | Yes | 0 - 2147483647 |
- The
topologyandtarget_polycountinputs are only available whenshould_remeshis set to"true". - The
enable_pbr,texture_prompt, andtexture_imageinputs are only available whenshould_textureis set to"true". - You cannot use
texture_promptandtexture_imageat the same time. If both are provided whenshould_textureis"true", the node will raise an error.
Outputs
| Output Name | Description | Data Type |
|---|---|---|
model_file | The filename of the generated GLB model. (Maintained for backward compatibility). | STRING |
meshy_task_id | The unique identifier for the Meshy API task, which can be used for reference or troubleshooting. | MESHY_TASK_ID |
GLB | The generated 3D model in the GLB file format. | FILE3DGLB |
FBX | The generated 3D model in the FBX file format. | FILE3DFBX |
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):
87825d9d78ccfb1efdf07da0e9c8cfca39a8446dd99d346c732e4d1470194205