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

# TripoImageToModelNodeV2 - ComfyUI Built-in Node Documentation

> The Tripo: Image to Model node turns a single reference image into a 3D model using Tripo's image-to-model service.

The Tripo: Image to Model node turns a single reference image into a 3D model using Tripo's image-to-model service. It uploads the image, submits a generation task, waits for the task to finish, and returns the resulting 3D file together with the task ID. This is an API node, so it requires a valid Comfy API key.

## Inputs

| Parameter           | Description                                                                                                                                                                                                                | Data Type | Required | Range                                        |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | -------------------------------------------- |
| `image`             | The reference image used to generate the 3D model.                                                                                                                                                                         | IMAGE     | Yes      | —                                            |
| `model_version`     | The model version to use for generation. If left unset, the node falls back to Tripo's v3.1 (20260211) version.                                                                                                            | COMBO     | No       | List of Tripo model versions                 |
| `texture`           | Generate texture maps. Off returns bare geometry and ignores `pbr` (default: true).                                                                                                                                        | BOOLEAN   | No       | true<br />false                              |
| `pbr`               | PBR material maps (base color, metallic, roughness, normal). Requires `texture` (default: true).                                                                                                                           | BOOLEAN   | No       | true<br />false                              |
| `model_seed`        | Seed used for the geometry generation step (default: 42).                                                                                                                                                                  | INT       | No       | 0 to 2147483647                              |
| `orientation`       | Orientation setting applied to the generated model (default: DEFAULT).                                                                                                                                                     | COMBO     | No       | Tripo orientation options, default `DEFAULT` |
| `texture_seed`      | Seed used for the texture generation step (default: 42).                                                                                                                                                                   | INT       | No       | 0 to 2147483647                              |
| `texture_quality`   | detailed = HD textures, extreme = 8K Ultra textures (default: "standard").                                                                                                                                                 | COMBO     | No       | "standard"<br />"detailed"<br />"extreme"    |
| `texture_alignment` | How textures are aligned on the generated geometry (default: "original\_image").                                                                                                                                           | COMBO     | No       | "original\_image"<br />"geometry"            |
| `face_limit`        | Maximum face count. -1 lets Tripo pick adaptively (about 1.4M faces on v3.x standard, 2M on detailed). Tripo clamps silently: v2.5 at 500,000, quad meshes at 150,000 (default: -1).                                       | INT       | No       | -1 to 2000000                                |
| `quad`              | Quad mesh output. Tripo delivers quad meshes as FBX, so the result arrives on the FBX output and the GLB output stays empty (default: false).                                                                              | BOOLEAN   | No       | true<br />false                              |
| `geometry_quality`  | The quality level of the generated geometry (default: "standard").                                                                                                                                                         | COMBO     | No       | "standard"<br />"detailed"                   |
| `smart_low_poly`    | Low-poly mesh with clean, hand-crafted style topology (500-20,000 faces, quad 500-10,000). Best for simple subjects; complex ones may fail (default: false).                                                               | BOOLEAN   | No       | true<br />false                              |
| `auto_size`         | Scale textured models to their real-world size in meters. Tripo stores the size as the model's scene transform and bakes it in when the model is converted, rigged or retargeted; ignored without texture (default: true). | BOOLEAN   | No       | true<br />false                              |

**Notes:**

* `image` is required; the node raises an error if no image is supplied.
* When `smart_low_poly` is enabled and `face_limit` is set to a value other than -1, the limit must be between 500 and 20,000 for triangle meshes, or between 500 and 10,000 when `quad` is enabled. Other values raise an error.
* When `texture` is disabled, `pbr` is forced off regardless of its setting, and `auto_size` has no effect.
* A `face_limit` of -1 is sent to Tripo as "no limit", letting the service choose adaptively.
* A new 3D file format the node cannot return (anything other than GLB or FBX) causes an error.

## Outputs

| Output Name     | Description                                                                | Data Type       |
| --------------- | -------------------------------------------------------------------------- | --------------- |
| `model task_id` | The Tripo task ID of the generation job.                                   | MODEL\_TASK\_ID |
| `GLB`           | The generated model as a GLB file. Empty when `quad` is enabled.           | FILE3DGLB       |
| `FBX`           | The generated model as an FBX file. Only populated when `quad` is enabled. | 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/TripoImageToModelNodeV2/en.md)

***

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