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

# TripoImageToModelNode - ComfyUI Built-in Node Documentation

> Generates 3D models synchronously based on a single image using Tripo's API.

Generates 3D models synchronously based on a single image using Tripo's API. Provide an input image, and the node creates a finished 3D model from it, with optional controls for model version, texture generation, level of detail, and output format. This is the legacy version of the image-to-model node, kept for older workflows.

## Inputs

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `image` | The input image used to generate the 3D model. An image must be provided, otherwise the node raises an error. | IMAGE | Yes | - |
| `model_version` | The model version to use for generation. | COMBO | No | `"v1.4"`<br />`"v3.0"`<br />`"v3.5"`<br />`"v3.6"` |
| `style` | No longer supported by Tripo and ignored. Kept for older workflows. (default: `"None"`) | COMBO | No | `"None"`<br />`"realistic"`<br />`"cartoon"`<br />`"sculpture"`<br />`"low_poly"` |
| `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` | Random seed for model generation. (default: 42) | INT | No | 0 to 2147483647 |
| `orientation` | Orientation setting for the generated model. (default: `"default"`) | COMBO | No | `"default"`<br />`"front"`<br />`"back"`<br />`"left"`<br />`"right"`<br />`"top"`<br />`"bottom"` |
| `texture_seed` | Random seed for texture generation. (default: 42) | INT | No | 0 to 2147483647 |
| `texture_quality` | Quality level for texture generation: `detailed` = HD textures, `extreme` = 8K Ultra textures. (default: `"standard"`) | COMBO | No | `"standard"`<br />`"detailed"`<br />`"extreme"` |
| `texture_alignment` | Alignment method for texture mapping. (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` | Quality level for geometry generation. (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 |

Note: An `image` is required; if it is missing, the node raises a RuntimeError. When `texture` is False, the model contains bare geometry only and `pbr` is forced to False. When `smart_low_poly` is enabled, `face_limit` must be between 500 and 20,000 for triangle meshes, or between 500 and 10,000 when `quad` is also enabled; if the limit is invalid, the node raises a ValueError. Setting `face_limit` to -1 (the default) sends no explicit face limit to the API, letting Tripo choose adaptively.

## Outputs

| Output Name | Description | Data Type |
| - | - | - |
| `model_file` | The generated 3D model file (for backward compatibility only). | STRING |
| `model task_id` | The task ID for tracking the model generation process. | MODEL\_TASK\_ID |
| `GLB` | The generated 3D model in GLB format. Empty when `quad` is enabled. | FILE3DGLB |
| `FBX` | The generated 3D model in FBX format. 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/TripoImageToModelNode/en.md)

***

**Source fingerprint (SHA-256):** `3b278abfd13329ee58ebab1bfeb47d32d09f4797f3d8628a35a028c3d15a7314`


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