Skip to main content

Query Real-Person Asset Group Detail

GET /api/volc-user/asset-groups/detail

Query a verified group by its platform group ID. To list its assets, use List Real-Person Assets with groupIds.

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​

NameTypeRequiredDescription
idstringRequiredQuery parameter: platform resource ID

Request Example​

GET /api/volc-user/asset-groups/detail?id=group-example
Authorization: <access_token>

Response Fields (200)​

NameTypeDescription
successbooleanBusiness success flag; check it even for HTTP 200
messagestringMessage; empty on success
dataobjectResponse data on success
data.idstringPlatform asset group ID
data.namestringGroup name
data.descriptionstringGroup description
data.groupTypestringLivenessFace for real-person groups
data.createTimeintegerCreation time in Unix seconds
data.updateTimeintegerUpdate time in Unix seconds
data.remarkstringPlatform remark; currently identical to description

Response Example​

{
"success": true,
"message": "",
"data": {
"id": "group-example",
"name": "Performer Asset Group",
"description": "For authorized video generation",
"groupType": "LivenessFace",
"createTime": 1792022430,
"updateTime": 1792022430,
"remark": "For authorized video generation"
}
}