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

# TripoPSeriesImageToModelNode - ComfyUI Built-in Node Documentation

> Generates a low-poly 3D model with clean topology from a single image using Tripo's P2 model.

Generates a low-poly 3D model with clean topology from a single image using Tripo's P2 model. The result comes back as a triangle mesh (GLB) or, when `model.quad` is enabled, as a quad-dominant mesh (FBX).

## Inputs

### Common Inputs

| Parameter | Description                                                                  | Data Type      | Required | Range  |
| --------- | ---------------------------------------------------------------------------- | -------------- | -------- | ------ |
| `model`   | Tripo P-series model to use. Selecting a model reveals its own inputs below. | DYNAMIC\_COMBO | Yes      | `"P2"` |

### P2 Inputs

| Parameter                    | Description                                                                                                                                                                   | Data Type | Required | Range                                                         |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------------------------------------------------- |
| `model.image`                | The image the model is generated from.                                                                                                                                        | IMAGE     | Yes      | -                                                             |
| `model.quad`                 | Return a quad-dominant mesh on the FBX output instead of a triangle mesh on the GLB output (default: False).                                                                  | BOOLEAN   | Yes      | True/False                                                    |
| `model.face_limit`           | Target face count. `-1` lets Tripo choose. With `model.quad` enabled the limit is 48 to 25,000, otherwise 48 to 50,000 (default: -1).                                         | INT       | Yes      | -1, or 48 to 50000                                            |
| `model.texture`              | Base color texture resolution: standard is 2K, detailed 4K and extreme 8K. `"none"` returns an untextured mesh (default: `"standard"`).                                       | COMBO     | Yes      | `"standard"`<br />`"detailed"`<br />`"extreme"`<br />`"none"` |
| `model.pbr`                  | Add metallic, roughness and normal maps to the base color. Ignored when `model.texture` is `"none"` (default: True).                                                          | BOOLEAN   | Yes      | True/False                                                    |
| `model.model_seed`           | Seed for the geometry (default: 42).                                                                                                                                          | INT       | Yes      | 0 to 2147483647                                               |
| `model.texture_alignment`    | Match the colors of the input image, or fit the textures to the generated geometry. Ignored when `model.texture` is `"none"` (default: `"original_image"`). Advanced setting. | COMBO     | Yes      | `"original_image"`<br />`"geometry"`                          |
| `model.orientation`          | `"align_image"` rotates the model to the viewpoint of the input image. Ignored when `model.texture` is `"none"` (default: `"default"`). Advanced setting.                     | COMBO     | Yes      | `"default"`<br />`"align_image"`                              |
| `model.enable_image_autofix` | Let Tripo enhance a low-resolution or low-quality image before modeling (default: False). Advanced setting.                                                                   | BOOLEAN   | Yes      | True/False                                                    |
| `model.texture_seed`         | Seed for the textures (default: 42). Advanced setting.                                                                                                                        | INT       | Yes      | 0 to 2147483647                                               |
| `model.auto_size`            | Scale the model to its real-world size in meters through its scene transform. Ignored when `model.texture` is `"none"` (default: False). Advanced setting.                    | BOOLEAN   | Yes      | True/False                                                    |
| `model.export_uv`            | UV unwrap the mesh when it is untextured. Textured meshes are always unwrapped (default: True). Advanced setting.                                                             | BOOLEAN   | Yes      | True/False                                                    |
| `model.compress_geometry`    | Apply meshopt geometry compression: much smaller files, but ComfyUI's 3D preview cannot display them. Ignored for quad meshes (default: False). Advanced setting.             | BOOLEAN   | Yes      | True/False                                                    |

**Notes:**

* `model.image` is required and only the first image of the batch is used.
* `model.face_limit` is a target rather than a hard cap, so the result can contain more faces than requested. `-1` leaves the choice to Tripo.
* `model.quad` decides which output carries the mesh. With it enabled the model arrives on the FBX output and the GLB output stays empty; with it disabled the model arrives on GLB and FBX stays empty. The node raises an error if the empty output is the one you connected.
* `model.texture`, `model.pbr`, `model.texture_seed`, `model.auto_size`, `model.texture_alignment` and `model.orientation` only apply to textured models: with `"none"` the node sends no texture settings and returns bare geometry.
* `model.compress_geometry` has no effect on quad meshes.

## Outputs

| Output Name     | Description                                                                        | Data Type       |
| --------------- | ---------------------------------------------------------------------------------- | --------------- |
| `model task_id` | The unique task ID for the model generation request.                               | MODEL\_TASK\_ID |
| `GLB`           | The generated 3D model in GLB format. Empty when `model.quad` is enabled.          | FILE3DGLB       |
| `FBX`           | The generated 3D model in FBX format. Only populated when `model.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/TripoPSeriesImageToModelNode/en.md)

***

**Source fingerprint (SHA-256):** `9bfad31ee00546d0603ce3273502cfc93c79e3b125941fed255866aa83f770a5`