> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-cms-changelog-node-lifecycle.mintlify.site/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.

## 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):** `79ebe76234036e8284640d7eaeee3a1220975b8adc043994de7de0ee161ccd45`