# 获取素材列表

列出当前用户拥有的素材，支持按分组、名称、状态筛选。

## GET /v1/assets

> 获取素材列表

列出当前用户拥有的素材，支持按分组、名称、状态筛选。

### Authentication

`Authorization: Bearer tr-xxx`

### Query Parameters

- **page_num** `integer`  
  页码，从 1 开始
- **page_size** `integer`  
  每页数量，最大 100
- **group_id** `string`  
  按指定分组 ID 筛选（必须是当前用户拥有的分组）
- **type** `string`  
  分组类型, 上游火山 Ark 必填项. `aigc` (默认) 查 AIGC 素材组; `real_person` 查 validate-session 流程产生的真人 (LivenessFace) 组. **即使传了 `group_id` 也要配对正确的 `type`**: 查真人组的素材必须传 `type=real_person`, 否则按默认 `aigc` 过滤会返回空列表。上游只接受单一类型, 没有"返所有"这一档。

- **name** `string`  
  按素材名称筛选（模糊匹配）
- **statuses** `string`  
  按状态筛选：`Active`、`Processing`、`Failed`

### Response

- **Items** `object[]`  
  素材列表
- **Items[].Id** `string`  
  素材 ID，可通过 `asset://<Id>` 格式在视频生成等接口中引用
- **Items[].Name** `string`  
  素材名称
- **Items[].AssetType** ``Image` | `Video` | `Audio``  
  素材类型
- **Items[].Status** ``Active` | `Processing` | `Failed``  
  素材处理状态：
- **Items[].GroupId** `string`  
  所属分组 ID
- **Items[].URL** `string`  
  素材文件 URL
- **Items[].CreateTime** `string`  
  创建时间
- **Items[].UpdateTime** `string`  
  最后更新时间
- **Items[].Error** `object`  
  错误信息，仅当 `Status: Failed` 时有值
- **TotalCount** `integer`  
  总数量
- **PageNumber** `integer`  
  当前页码
- **PageSize** `integer`  
  每页数量

### Error Codes

- `401`: 
- `403`: 指定的分组不属于当前用户
- `429`: