查询真人素材组列表

GET /api/volc-user/asset-groups

分页查询当前用户可见的真人人像素材组，固定指定 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	可选	按名称模糊搜索
sortBy	string	可选	排序字段：Id、CreateTime、UpdateTime、Name、GroupType
sortOrder	string	可选	Asc 升序，其他值按降序处理

请求示例

GET /api/volc-user/asset-groups?pageNumber=1&pageSize=20&groupType=LivenessFace&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
data.items[].name	string	素材组名称
data.items[].description	string	素材组描述
data.items[].groupType	string	真人人像固定为 LivenessFace
data.items[].createTime	integer	创建时间，Unix 秒
data.items[].updateTime	integer	更新时间，Unix 秒
data.items[].remark	string	平台备注，当前与 description 一致

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "totalCount": 1,
    "pageNumber": 1,
    "pageSize": 20,
    "items": [
      {
        "id": "group-example",
        "name": "演员本人素材组",
        "description": "用于授权的视频生成",
        "groupType": "LivenessFace",
        "createTime": 1792022430,
        "updateTime": 1792022430,
        "remark": "用于授权的视频生成"
      }
    ]
  }
}

projectName 不属于用户接口参数，响应也不包含项目名或上游素材组 ID。