Management APIReal-Person Verification & Asset Management
List Portrait Assets
Authorization
BearerAuth
AuthorizationBearer <token>
API Key (sk-xxxxxx)
In: header
Request Body
application/json
group_ids?array<string>
List of portrait group IDs (Group IDs). Obtainable from the group_id field returned by the Get Liveness Result and Query GroupId API.
⚠️ Important Note Batch Query Support This field is an array type and can accept multiple group_ids for batch queries. A single request supports querying assets from up to 100 portrait groups.
group_type?string
Group type, defaults to LivenessFace
statuses?array<string>
Status filters, supports Active / Processing / Failed
name?string
Asset name, supports fuzzy search
page_number?integer
Page number, defaults to 1
page_size?integer
Page size, defaults to 20, max 100
sort_by?string
Sorting field, defaults to CreateTime; supports CreateTime / UpdateTime / GroupId
sort_order?string
Sorting order, defaults to Desc
Response Body
application/json
curl -X POST "https://easyrouter.io/api/resource-channel/byteplus/visual-validate/assets/list" \ -H "Content-Type: application/json" \ -d '{}'{
"success": true,
"message": "",
"data": {
"items": [
{
"id": "asset-20260521164235-zggcb",
"name": "test123",
"url": "https://ark-media-asset-ap-southeast-1.tos-ap-southeast-1.volces.com/3002350283/052116423588429180.png?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=***&X-Tos-Date=20260521T084901Z&X-Tos-Expires=43200&X-Tos-Security-Token=***&X-Tos-Signature=***&X-Tos-SignedHeaders=host",
"group_id": "group-20260521163909-kbdhw",
"asset_type": "Image",
"status": "Failed",
"error": {
"code": "FaceMismatch",
"message": "Face consistency verification failed."
},
"create_time": "2026-05-21T08:42:35Z",
"update_time": "2026-05-21T08:42:38Z"
}
],
"total_count": 1,
"page_number": 1,
"page_size": 10
}
}