# 获取素材列表

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

## GET /v1/assets

> List assets

List assets owned by the current user with filtering by group, name, and status.

### Authentication

`Authorization: Bearer tr-xxx`

### Query Parameters

- **page_num** `integer`  
  Page number, starting from 1
- **page_size** `integer`  
  Items per page, maximum 100
- **group_id** `string`  
  Filter by group ID (must be a group owned by the current user)
- **type** `string`  
  Group type, required by upstream Volcengine Ark. `aigc` (default) lists AIGC asset groups; `real_person` lists liveness (LivenessFace) groups created via the validate-session flow. **You must pass the matching `type` even when `group_id` is set**: to list a real-person group's assets, pass `type=real_person`, otherwise the default `aigc` filter returns an empty list. Upstream accepts only a single type; there is no "return all" option.

- **name** `string`  
  Filter by asset name (fuzzy match)
- **statuses** `string`  
  Filter by status: `Active`, `Processing`, `Failed`

### Response

- **Items** `object[]`  
  Asset list
- **Items[].Id** `string`  
  Asset ID. Can be referenced in video generation and other endpoints using `asset://<Id>` format
- **Items[].Name** `string`  
  Asset name
- **Items[].AssetType** ``Image` | `Video` | `Audio``  
  Asset type
- **Items[].Status** ``Active` | `Processing` | `Failed``  
  Asset processing status:
- **Items[].GroupId** `string`  
  Parent group ID
- **Items[].URL** `string`  
  Asset file URL
- **Items[].CreateTime** `string`  
  Creation time
- **Items[].UpdateTime** `string`  
  Last updated time
- **Items[].Error** `object`  
  Error information. Only present when `Status: Failed`
- **TotalCount** `integer`  
  Total count
- **PageNumber** `integer`  
  Current page number
- **PageSize** `integer`  
  Items per page

### Error Codes

- `401`: 
- `403`: Specified group does not belong to the current user
- `429`: