# 智能分割

**Base URL:** `https://openapi.tripo3d.ai/v3`

**Endpoint:** `POST /mesh/smartsegment`

端到端智能分割 pipeline。通过 `file_token` 或 URL 提交，支持 `seg_type=image` 与 `seg_type=model`（仅 GLB）。与网格分割的区别：SmartSegment 含自动建模；`/v3/mesh/segment` 仅对已有模型分割。

## Request Parameters

### seg_type

- **Type:** string
- **Required:** 必选

分割类型。
- `image`：图片 pipeline（PNG / JPEG / WebP）
- `model`：模型 pipeline（**仅 GLB**；须传 `transform`）

### input

- **Type:** string
- **Required:** 必选

输入源。接受 `file_token`（文件上传 或 大文件直传返回）或外部 URL。`seg_type=model` 时文件**必须为 GLB**。

### granularity

- **Type:** string
- **Required:** 可选
- **Default:** `medium`

分割粒度。
- `coarse`
- `medium`：默认
- `fine`

### hint

- **Type:** string
- **Required:** 可选

可选提示词，辅助识别需要分割的部件。
### transform

- **Type:** number[]
- **Required:** 条件必填

**`seg_type=model` 时必填**。列主序 4×4 变换矩阵（16 个 float）。单位矩阵示例：`[1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1]`

## Request Example

### 图片 pipeline

```bash
curl --request POST \
  --url https://openapi.tripo3d.ai/v3/mesh/smartsegment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "seg_type": "image",
  "input": "file_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "granularity": "medium",
  "hint": "game character with sword and armor"
}'
```

### 模型 pipeline

```bash
curl --request POST \
  --url https://openapi.tripo3d.ai/v3/mesh/smartsegment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "seg_type": "model",
  "input": "https://example.com/character.glb",
  "transform": [
    1,
    0,
    0,
    0,
    0,
    1,
    0,
    0,
    0,
    0,
    1,
    0,
    0,
    0,
    0,
    1
  ],
  "granularity": "fine",
  "hint": "character body parts"
}'
```


## Response Example

### 创建任务

```json
{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}
```

### 任务结果

```json
{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "type": "smartsegment_image",
    "status": "success",
    "progress": 100,
    "input": {
      "granularity": "medium"
    },
    "output": {
      "prompt": "head, body, left arm, right arm, legs",
      "mask_url": "https://cdn.tripo3d.ai/output/mask.png",
      "seg_model_url": "https://cdn.tripo3d.ai/output/seg_model.glb",
      "seg_task_id": "task_seg456",
      "model_task_id": "task_model789"
    },
    "credits_consumed": 85.00,
    "created_at": "2026-06-30T09:08:14Z",
    "completed_at": "2026-06-30T09:14:15Z"
  }
}
```