# AI3D API v2 model: tripo-smartsegment-model

Run Tripo Smart Segmentation's model pipeline on an existing GLB and archive the segmented model.

- AI3D model ID: `tripo-smartsegment-model` (native Tripo API, `mesh/smartsegment`, model pipeline)
- Task: `model_to_model`
- Provider adapter: `tripo`
- Availability: listed in `GET /v2/models` when Tripo credentials are configured and `TRIPO_OPERATIONS_MODE=on`. During `canary`, it stays out of the public catalog and Playground.
- Provider reference: <https://developers.tripo3d.ai/en/docs/mesh-smartsegment>

Create a normal prepaid AI3D job. Do not call Tripo directly or put a provider key in a client.

```http
POST https://api.ai3d.dev/v2/jobs
Authorization: Bearer <AI3D_API_KEY>
Content-Type: application/json
```

The model pipeline takes a public HTTPS `model_url` ending in `.glb`. AI3D does not fetch the model; Tripo does. `input.transform` is required and must be a column-major 4×4 matrix of 16 finite numbers. The Playground supplies the identity matrix by default.

```json
{
  "model": "tripo-smartsegment-model",
  "model_url": "https://example.com/character.glb",
  "input": {
    "transform": [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1],
    "granularity": "fine",
    "hint": "separate the character's body parts"
  }
}
```

`input.granularity` is `coarse`, `medium` (default), or `fine`. `input.hint` is optional and may contain up to 1,024 characters. The Playground provides a GLB URL field, granularity selector, hint field, and editable transform matrix.

Tripo lists Smart Segmentation (Model) at 55 credits ($0.55). AI3D reserves this amount and settles from `credits_consumed`, capped at the reservation. If Tripo omits usage, AI3D charges the estimate. A provider failure releases the reservation. The generated segmented GLB and mask image are archived; the GLB opens in the 3D viewer. See [Tripo pricing](https://developers.tripo3d.ai/en/pricing).