List Real-Person Asset Groups

GET /api/volc-user/asset-groups

List real-person asset groups visible to the current user with groupType=LivenessFace. These groups are created through successful verification.

Authentication

Use a logged-in session Cookie or the Authorization: <access_token> header. Obtain the access token through Generate Access Token. It is different from the sk- key used for model requests.

Request Parameters

Name	Type	Required	Description
pageNumber	integer	Optional	Page number, starting at 1; defaults to 1
pageSize	integer	Optional	Page size; defaults to 20 and resets to 20 when below 1 or above 100
groupType	string	Required	Set to LivenessFace
groupIds	string[]	Optional	Platform group IDs; repeat the parameter or separate IDs with commas
name	string	Optional	Search names by substring
sortBy	string	Optional	Sort field: Id, CreateTime, UpdateTime, Name, GroupType
sortOrder	string	Optional	Asc for ascending; other values use descending order

Request Example

GET /api/volc-user/asset-groups?pageNumber=1&pageSize=20&groupType=LivenessFace&sortBy=CreateTime&sortOrder=Desc
Authorization: <access_token>

Response Fields (200)

Name	Type	Description
success	boolean	Business success flag; check it even for HTTP 200
message	string	Message; empty on success
data	object	Response data on success
data.totalCount	integer	Total number of records
data.pageNumber	integer	Current page number
data.pageSize	integer	Page size
data.items	array<object>	Records on the current page
data.items[].id	string	Platform asset group ID
data.items[].name	string	Group name
data.items[].description	string	Group description
data.items[].groupType	string	LivenessFace for real-person groups
data.items[].createTime	integer	Creation time in Unix seconds
data.items[].updateTime	integer	Update time in Unix seconds
data.items[].remark	string	Platform remark; currently identical to description

Response Example

{
  "success": true,
  "message": "",
  "data": {
    "totalCount": 1,
    "pageNumber": 1,
    "pageSize": 20,
    "items": [
      {
        "id": "group-example",
        "name": "Performer Asset Group",
        "description": "For authorized video generation",
        "groupType": "LivenessFace",
        "createTime": 1792022430,
        "updateTime": 1792022430,
        "remark": "For authorized video generation"
      }
    ]
  }
}

projectName is not a user API parameter. Responses do not expose project names or upstream group IDs.