查询真人素材列表

GET /api/volc-user/assets

分页查询当前用户可见的真人人像素材。必须指定 groupType=LivenessFace，可按组、名称和平台启用状态筛选。

鉴权说明

用户控制台接口，使用登录会话 Cookie，或请求头 Authorization: <access_token>。访问令牌由 生成访问令牌 获取，与模型调用使用的 sk- 密钥不同。

请求参数

参数名	类型	必选	说明
pageNumber	integer	可选	页码，从 1 开始，默认 1
pageSize	integer	可选	每页数量，默认 20；小于 1 或大于 100 时回退为 20
groupType	string	必选	固定传 LivenessFace
groupIds	string[]	可选	平台素材组 ID；支持重复参数或逗号分隔
name	string	可选	按名称模糊搜索
assetStatus	integer	可选	平台启用状态：1 正常、2 禁用；不传则不筛选
sortBy	string	可选	排序字段：Id、CreateTime、UpdateTime、Name
sortOrder	string	可选	Asc 升序，其他值按降序处理

请求示例

GET /api/volc-user/assets?pageNumber=1&pageSize=20&groupType=LivenessFace&groupIds=group-example&assetStatus=1&sortBy=CreateTime&sortOrder=Desc
Authorization: <access_token>

响应字段（200）

字段名	类型	说明
success	boolean	业务是否成功；HTTP 200 仍需检查此字段
message	string	提示信息，成功时为空字符串
data	object	成功时的响应数据
data.totalCount	integer	总数量
data.pageNumber	integer	当前页码
data.pageSize	integer	每页数量
data.items	array<object>	当前页记录
data.items[].id	string	平台素材 ID，视频生成使用 asset://<id>
data.items[].name	string	素材名称
data.items[].url	string	仅 Active 时展示上游访问 URL；Processing/Failed 时为空字符串，不作为永久地址保存
data.items[].assetType	string	Image、Video、Audio
data.items[].groupId	string	所属平台素材组 ID
data.items[].status	string	处理状态：Processing、Active、Failed
data.items[].assetStatus	integer	平台启用状态：1 正常、2 禁用；与处理状态 status 不同
data.items[].createTime	integer	创建时间，Unix 秒
data.items[].updateTime	integer	更新时间，Unix 秒
data.items[].remark	string	平台备注
data.items[].error	object	仅 Failed 时返回失败信息，包含 code 和 message
data.items[].error.code	string	稳定错误码，例如 ASSET_PREPARATION_FAILED
data.items[].error.message	string	可翻译的错误说明

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "totalCount": 1,
    "pageNumber": 1,
    "pageSize": 20,
    "items": [
      {
        "id": "asset-example",
        "name": "本人正面照",
        "url": "https://example.com/approved-portrait.jpg",
        "assetType": "Image",
        "groupId": "group-example",
        "status": "Active",
        "assetStatus": 1,
        "createTime": 1792022440,
        "updateTime": 1792022450,
        "remark": "external-asset-001"
      }
    ]
  }
}

当前接口不支持 statuses 参数，传入会报参数错误。projectName 不属于用户接口参数；处理状态请读取返回的 status。