Inputs
| Parameter | Description | Data Type | Required | Range |
|---|---|---|---|---|
model | Specifies the AI model version to use. | COMBO | Yes | "latest" |
images | A set of images used to generate the 3D model. You must provide between 2 and 4 images. | IMAGE | Yes | 2 to 4 images |
should_remesh | Determines if the generated mesh should be processed. When set to "false", the node returns an unprocessed triangular mesh. | COMBO | Yes | "true""false" |
topology | The target polygon type for the remeshed output. This parameter is only available and required when should_remesh is set to "true". | COMBO | No | "triangle""quad" |
target_polycount | The target number of polygons for the remeshed model (default: 300000). This parameter is only available when should_remesh is set to "true". | INT | No | 100 to 300000 |
symmetry_mode | Controls whether symmetry is applied to the generated model. | COMBO | Yes | "auto""on""off" |
should_texture | Determines whether textures are generated. Setting it to "false" skips the texture phase and returns a mesh without textures. | 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 (default: False). | BOOLEAN | No | True / False |
texture_prompt | A text prompt to guide the texturing process (maximum 600 characters). Cannot be used at the same time as texture_image. This parameter is only available when should_texture is set to "true". | STRING | No | - |
texture_image | An image to guide the texturing process. Only one of texture_image or texture_prompt may be used at the same time. This parameter is only available when should_texture is set to "true". | IMAGE | No | - |
pose_mode | Specifies the pose mode for the generated model. | COMBO | Yes | "" (empty)"A-pose""T-pose" |
seed | A seed value for the generation process (default: 0). Results are non-deterministic regardless of the seed, but changing the seed can trigger the node to re-run. | INT | Yes | 0 to 2147483647 |
- You must provide between 2 and 4 images for the
imagesinput. - The
topologyandtarget_polycountparameters are only active whenshould_remeshis set to"true". - The
enable_pbr,texture_prompt, andtexture_imageparameters are only active whenshould_textureis set to"true". - You cannot use
texture_promptandtexture_imageat the same time; they are mutually exclusive.
Outputs
| Output Name | Description | Data Type |
|---|---|---|
model_file | The filename of the generated GLB model. This output is provided for backward compatibility. | STRING |
meshy_task_id | The unique identifier for the Meshy API task. | MESHY_TASK_ID |
GLB | The generated 3D model in GLB format. | FILE3DGLB |
FBX | The generated 3D model in FBX 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):
7118368e2d9c1a7df9866d19a033c6e2efd632381624a9ee537552502185d444