> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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"`<br />`"meshy-7"`<br />`"meshy-6"`<br />`"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"`<br />`"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"`<br />`"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"`<br />`"on"`<br />`"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 | `""`<br />`"A-pose"`<br />`"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<br />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"`<br />`"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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshyTextToModelNode/en.md)

***

**Source fingerprint (SHA-256):** `a02a5ae28bcae343c628d11ba3efa952b61b8bdf867669f58f1beb0f7c9e49f9`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.