> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MeshyImageToModelNode - ComfyUI Built-in Node Documentation

> The Meshy: Image to Model node uses the Meshy API to generate a 3D model from a single input image.

The Meshy: Image to Model node uses the Meshy API to generate a 3D model from a single input image. It uploads your image, submits a processing task, and returns the generated 3D model files (GLB and FBX) along with the task ID for reference.

## Inputs

| Parameter            | Description                                                                                                                                                                                                                     | Data Type      | Required | Range                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -------- | -------------------------------------------- |
| `model`              | Specifies the AI model version to use for generation.                                                                                                                                                                           | COMBO          | Yes      | `"meshy-7"`<br />`"meshy-6"`<br />`"latest"` |
| `image`              | The input image to convert into a 3D model.                                                                                                                                                                                     | IMAGE          | Yes      | -                                            |
| `should_remesh`      | When set to `"false"`, returns an unprocessed triangular mesh.                                                                                                                                                                  | DYNAMIC\_COMBO | Yes      | `"true"`<br />`"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"`<br />`"quad"`                   |
| `target_polycount`   | The target number of polygons for the remeshed model. This input is only available when `should_remesh` is set to `"true"`. Default: 300000.                                                                                    | INT            | No\*     | 100 - 300000                                 |
| `symmetry_mode`      | Controls the symmetry applied to the generated 3D model.                                                                                                                                                                        | COMBO          | Yes      | `"auto"`<br />`"on"`<br />`"off"`            |
| `should_texture`     | Determines whether textures are generated. Setting it to `"false"` skips the texture phase and returns a mesh without textures.                                                                                                 | DYNAMIC\_COMBO | Yes      | `"true"`<br />`"false"`                      |
| `enable_pbr`         | Generate PBR Maps (metallic, roughness, normal) in addition to the base color. This input is only available when `should_texture` is set to `"true"`. Default: `False`.                                                         | BOOLEAN        | No\*     | -                                            |
| `texture_prompt`     | Provide a text prompt to guide the texturing process. Maximum 600 characters. Cannot be used at the same time as `texture_image`. This input is only available when `should_texture` is set to `"true"`. Default: empty string. | STRING         | No\*     | -                                            |
| `texture_image`      | Only one of `texture_image` or `texture_prompt` may be used at the same time. This input is only available when `should_texture` is set to `"true"`.                                                                            | IMAGE          | No\*     | -                                            |
| `texture_resolution` | Base color texture resolution. Higher resolutions capture more surface detail. This input is only available when `should_texture` is set to `"true"`.                                                                           | COMBO          | No\*     | `"2k"`<br />`"4k"`<br />`"8k"`               |
| `pose_mode`          | Specify the pose mode for the generated model. This is an advanced parameter.                                                                                                                                                   | COMBO          | Yes      | `""` (empty)<br />`"A-pose"`<br />`"T-pose"` |
| `seed`               | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. Default: 0.                                                                                                                     | INT            | Yes      | 0 - 2147483647                               |
| `ultra_mode`         | Run an extra refinement pass for higher-fidelity geometry with finer surface detail. Default: `False`.                                                                                                                          | BOOLEAN        | Yes      | -                                            |

**Note on Parameter Constraints:**

* The `topology` and `target_polycount` inputs are only available when `should_remesh` is set to `"true"`.
* The `enable_pbr`, `texture_prompt`, `texture_image`, and `texture_resolution` inputs are only available when `should_texture` is set to `"true"`.
* When `should_texture` is set to `"true"`, `texture_prompt` and `texture_image` cannot be used at the same time. If both are provided, the node raises an error.
* `texture_prompt` has a maximum length of 600 characters.
* `ultra_mode` requires the `"meshy-7"` or `"latest"` model. If `ultra_mode` is enabled with the `"meshy-6"` model, the node raises an error.

## Outputs

| Output Name     | Description                                                                                       | Data Type       |
| --------------- | ------------------------------------------------------------------------------------------------- | --------------- |
| `model_file`    | The filename of the generated GLB model. Maintained for backward compatibility only.              | 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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshyImageToModelNode/en.md)

***

**Source fingerprint (SHA-256):** `689828ad52de4493e1039aecc408e18af4122d2c0e2511fd254ba0f1d56bad14`