# 获取素材分组列表

列出当前用户的素材分组，支持分页和按名称筛选。

**第三方 SaaS** 调用方应传 `external_user_id`, 只看属于该 end-user 的 group; 不传则只返回直接绑到 API key 持有者的 group (老行为 / 第一方场景).

## GET /v1/asset-groups

> 获取素材分组列表

列出当前用户的素材分组，支持分页和按名称筛选。

**第三方 SaaS** 调用方应传 `external_user_id`, 只看属于该 end-user 的 group; 不传则只返回直接绑到 API key 持有者的 group (老行为 / 第一方场景).

### Authentication

`Authorization: Bearer tr-xxx`

### Query Parameters

- **page_num** `integer`  
  页码，从 1 开始
- **page_size** `integer`  
  每页数量，最大 100
- **name** `string`  
  按分组名称筛选（模糊匹配）
- **type** `string`  
  分组类型. `aigc` (默认) 返回 AIGC 素材组; `real_person` 返回 validate-session 流程产生的真人 (LivenessFace) 组. 上游火山 Ark 只接受单一类型, 没有"返所有"这一档, 需要两种都看时请分两次调用.

- **external_user_id** `string`  
  第三方 SaaS end-user 标识符 (可选). 设了之后只返回绑到 (api_user, external_user_id) 的 group; 不传 (或留空) 只返回直接绑到 API key 持有者的 group (老行为). 最大 128 字符.

### Response

- **Items** `object[]`  
  分组列表
- **Items[].Id** `string`  
  素材分组 ID
- **Items[].Name** `string`  
  分组名称
- **Items[].Description** `string`  
  分组描述
- **Items[].GroupType** ``AIGC``  
  分组类型，固定为 `AIGC`
- **Items[].CreateTime** `string`  
  创建时间
- **Items[].UpdateTime** `string`  
  最后更新时间
- **TotalCount** `integer`  
  总数量
- **PageNumber** `integer`  
  当前页码
- **PageSize** `integer`  
  每页数量

### Error Codes

- `401`: 
- `429`: