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

# TripoSmartSegmentNode - ComfyUI Built-in Node Documentation

> Splits a 3D model into semantically meaningful parts and gives each part a name.

Splits a 3D model into semantically meaningful parts and gives each part a name. It can either segment an existing model (provided through a task ID) or first generate a model from an image and then segment it. The resulting `segment task_id` can be used by other Tripo nodes, such as Complete Mesh Parts, Retopology, Texture model, and Convert model, in the same way as a Tripo: Segment Model result.

## Inputs

### Common Inputs

| Parameter | Description                                                                                                                                 | Data Type      | Required | Range                    |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -------- | ------------------------ |
| `source`  | Segment an existing model, or generate a model from an image and segment it. The selected option determines which additional inputs appear. | DYNAMIC\_COMBO | Yes      | `"model"`<br />`"image"` |

### Model Inputs

Shown when `source` is set to `"model"`.

| Parameter       | Description                                                                                              | Data Type       | Required | Range                                    |
| --------------- | -------------------------------------------------------------------------------------------------------- | --------------- | -------- | ---------------------------------------- |
| `model_task_id` | A GLB result. Quad (FBX) meshes must go through Tripo: Convert model (GLTF) first.                       | MODEL\_TASK\_ID | Yes      | -                                        |
| `granularity`   | How finely the model is split into parts (default: "medium").                                            | COMBO           | No       | `"coarse"`<br />`"medium"`<br />`"fine"` |
| `hint`          | Optional text naming the parts to look for, e.g. 'game character with sword and armor' (default: empty). | STRING          | No       | -                                        |

### Image Inputs

Shown when `source` is set to `"image"`. Tripo first generates a model from the image, then segments it.

| Parameter     | Description                                                                                              | Data Type | Required | Range                                    |
| ------------- | -------------------------------------------------------------------------------------------------------- | --------- | -------- | ---------------------------------------- |
| `image`       | The image used to generate the model that will be segmented.                                             | IMAGE     | Yes      | -                                        |
| `granularity` | How finely the model is split into parts (default: "medium").                                            | COMBO     | No       | `"coarse"`<br />`"medium"`<br />`"fine"` |
| `hint`        | Optional text naming the parts to look for, e.g. 'game character with sword and armor' (default: empty). | STRING    | No       | -                                        |

**Notes:**

* `granularity` and `hint` are shared by both `source` options and are optional. When `hint` is left empty, no hint is sent to the service.
* When `source` is `"model"`, only GLB models are accepted. Other formats, such as quad (FBX) meshes, must be converted first with Tripo: Convert model (GLTF).
* The task is polled until it reaches a terminal state, with an estimated duration of about 180 seconds. If Tripo returns an incomplete segmentation result, the node reports an error.
* Price badge: approximately 0.85 USD when `source` is `"image"` and approximately 0.55 USD when `source` is `"model"` (values shown as approximate).

## Outputs

| Output Name       | Description                                                              | Data Type         |
| ----------------- | ------------------------------------------------------------------------ | ----------------- |
| `segment task_id` | Task ID of the segmentation task, usable as input for other Tripo nodes. | SEGMENT\_TASK\_ID |
| `model task_id`   | The model that was segmented (generated from the image, or imported).    | MODEL\_TASK\_ID   |
| `GLB`             | The segmented 3D model file.                                             | FILE3DGLB         |
| `part_names`      | Comma-separated names of the parts.                                      | STRING            |
| `parts`           | Tripo's description of the parts it found.                               | STRING            |
| `mask`            | Mask image produced by the segmentation.                                 | IMAGE             |

> 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/TripoSmartSegmentNode/en.md)

***

**Source fingerprint (SHA-256):** `ba041da49e20b1ac085770078cce6ac87ef70eee927ba0ee9e5655a058893f1c`
