> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-claude-comfy-concurrency-limits-page-s84u33.mintlify.site/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`


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