MeshyTextToModelNode - ComfyUI Built-in Node Documentation

The Meshy: Text to Model node uses the Meshy API to generate a 3D model from a text description. It sends a request to the API with your prompt and settings, then waits for the generation to complete and downloads the resulting model files.

Inputs

Parameter	Description	Data Type	Required	Range
`model`	Specifies the AI model version to use for generation.	COMBO	Yes	`"meshy-7.1"` `"meshy-7"` `"meshy-6"` `"latest"`
`prompt`	The text description of the 3D model you want to generate. Must be between 1 and 600 characters long. Default is an empty string.	STRING	Yes	1 - 600 characters
`style`	The artistic style for the generated 3D model.	COMBO	Yes	`"realistic"`
`should_remesh`	When set to false, returns an unprocessed triangular mesh. Selecting “true” reveals additional parameters for topology and target polycount.	DYNAMIC_COMBO	Yes	`"true"` `"false"`
`topology`	The target polygon type for the remeshed model. This parameter 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. Default is 300000. This parameter is only available when `should_remesh` is set to “true”.	INT	No*	100 - 300000
`symmetry_mode`	Controls symmetry in the generated model. This is an advanced parameter. Options are `"auto"`, `"on"`, and `"off"`.	COMBO	Yes	`"auto"` `"on"` `"off"`
`pose_mode`	Specify the pose mode for the generated model. An empty string means no specific pose is requested. This is an advanced parameter.	COMBO	Yes	`""` `"A-pose"` `"T-pose"`
`seed`	Seed controls whether the node should re-run; results are non-deterministic regardless of seed. Default is 0.	INT	Yes	0 - 2147483647
`ultra_mode`	Run an extra refinement pass for higher-fidelity geometry with finer surface detail. Default is false.	BOOLEAN	Yes	true false
`ultra_resolution`	Resolution of the ultra pass: `"2k"` runs it at 2048³, `"4k"` at 4096³ for the finest surface detail. 4k requires the `"meshy-7.1"` or `"latest"` model. Used only when `ultra_mode` is enabled (default: `"2k"`).	COMBO	No	`"2k"` `"4k"`

*Note: The topology and target_polycount parameters are conditionally available. They only appear when the should_remesh parameter is set to “true”. When ultra_mode is enabled, the model parameter must be set to "meshy-7.1", "meshy-7" or "latest"; any other model raises an error. With "meshy-7" the ultra pass always runs at 2048³, and the "4k" ultra resolution requires "meshy-7.1" or "latest".

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 file in GLB format.	FILE3DGLB
`FBX`	The generated 3D model file 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): a02a5ae28bcae343c628d11ba3efa952b61b8bdf867669f58f1beb0f7c9e49f9

​Inputs

​Outputs

Inputs

Outputs