# AI3D API v2 model: tripo-segment

Run Tripo Mesh Segmentation on an existing 3D model and archive the segmented GLB.

- AI3D model ID: `tripo-segment` (native Tripo API, `mesh/segment`)
- 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`, only allowlisted customer accounts can submit it directly; it stays out of the public catalog and Playground.
- Provider reference: <https://developers.tripo3d.ai/en/docs/mesh-segment>

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
```

Use exactly one source:

- `source_job_id`: your own completed v2 Tripo generation job (`tripo-h31-image`, `tripo-h31-text`, `tripo-p1-image`, `tripo-p1-text`, or `tripo-p1-multiview`). AI3D passes the provider task ID to Tripo without exposing it in the AI3D response.
- `model_url`: a public HTTPS URL to a GLB, GLTF, FBX, OBJ, or STL model, up to Tripo's 150 MB limit. AI3D does not fetch this URL; Tripo does.

```json
{
  "model": "tripo-segment",
  "source_job_id": "3f6c0e2e-6a3f-4f1e-9d0c-1b2a3c4d5e6f",
  "input": {
    "model": "v2.0-20260430",
    "segmentation_granularity": "balanced",
    "split_by_connectivity": true
  }
}
```

`input.model` may be `v1.0-20250506` (default, geometry-based) or `v2.0-20260430` (semantic labeling plus geometry, beta). Only v2 accepts `segmentation_granularity` (`simple`, `balanced`, `detailed`), `split_by_connectivity` (boolean), and `ref_image` (public HTTPS reference mask URL). Tripo ignores granularity and connectivity when `ref_image` is supplied.

The Playground accepts completed Tripo source jobs or a public model URL and shows controls for the v1 and v2 request fields. A local reference mask must first be made available at a public HTTPS URL.

Tripo lists Mesh Segmentation at 40 credits ($0.40). 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. Successful GLB output is archived and opens in the 3D viewer. See [Tripo pricing](https://developers.tripo3d.ai/en/pricing).