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

# TripoTextToModelNode - ComfyUI Built-in Node Documentation

> Generates finished 3D models from a text description using Tripo's API.

Generates finished 3D models from a text description using Tripo's API. The node waits for generation to complete and then returns the model file, optionally with textures and PBR materials.

## Inputs

| Parameter          | Description                                                                                                                                                                                                                | Data Type | Required | Range                                     |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ----------------------------------------- |
| `prompt`           | Text description of the 3D model to generate (multiline). This parameter is required and cannot be empty.                                                                                                                  | STRING    | Yes      | -                                         |
| `negative_prompt`  | Text description of what to avoid in the generated model (multiline). Up to 255 characters. Sent to the API only when non-empty.                                                                                           | STRING    | No       | Up to 255 characters                      |
| `model_version`    | Version of the Tripo model to use for generation (default: v3.1-20260211).                                                                                                                                                 | COMBO     | No       | Multiple options available                |
| `style`            | Style applied to the generated model (default: None). No longer supported by Tripo and ignored; kept for older workflows.                                                                                                  | COMBO     | No       | Multiple options available                |
| `texture`          | Whether to generate texture maps. Off returns bare geometry and ignores `pbr` (default: True).                                                                                                                             | BOOLEAN   | No       | true / false                              |
| `pbr`              | Whether to generate PBR material maps (base color, metallic, roughness, normal). Requires `texture`; forced off when `texture` is off (default: True).                                                                     | BOOLEAN   | No       | true / false                              |
| `image_seed`       | Seed used for the image generation stage (default: 42).                                                                                                                                                                    | INT       | No       | 0 to 2147483647                           |
| `model_seed`       | Seed used for the model generation stage (default: 42).                                                                                                                                                                    | INT       | No       | 0 to 2147483647                           |
| `texture_seed`     | Seed used for the texture generation stage (default: 42).                                                                                                                                                                  | INT       | No       | 0 to 2147483647                           |
| `texture_quality`  | Quality of the generated textures. detailed = HD textures, extreme = 8K Ultra textures (default: standard).                                                                                                                | COMBO     | No       | "standard"<br />"detailed"<br />"extreme" |
| `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 / false                              |
| `geometry_quality` | Quality 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 / 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 / false                              |

**Notes:**

* The `prompt` parameter is mandatory: an empty prompt causes the node to raise an error.
* `pbr` requires `texture`. When `texture` is off, the node forces `pbr` to off and ignores its value. `auto_size` also has no effect without `texture`.
* When `smart_low_poly` is enabled and `face_limit` is set to a value other than -1, the face limit must be between 500 and 20,000 for triangle output, or between 500 and 10,000 when `quad` is enabled; otherwise the node raises an error.
* When `quad` is enabled, the generated quad mesh is delivered as FBX, so the FBX output is populated and the GLB output stays empty.

## Outputs

| Output Name     | Description                                                                  | Data Type       |
| --------------- | ---------------------------------------------------------------------------- | --------------- |
| `model_file`    | The generated 3D model file, kept for backward compatibility only.           | STRING          |
| `model task_id` | The unique task identifier for 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/TripoTextToModelNode/en.md)

***

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