List Real-Person Assets

GET /api/volc-user/assets

List real-person assets visible to the current user. Set groupType=LivenessFace; optionally filter by group, name, or platform enablement.

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
assetStatus	integer	Optional	Platform enablement: 1 enabled or 2 disabled; omit for all
sortBy	string	Optional	Sort field: Id, CreateTime, UpdateTime, Name
sortOrder	string	Optional	Asc for ascending; other values use descending order

Request Example

GET /api/volc-user/assets?pageNumber=1&pageSize=20&groupType=LivenessFace&groupIds=group-example&assetStatus=1&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 ID; reference it in video generation as asset://<id>
data.items[].name	string	Asset name
data.items[].url	string	Upstream URL shown only when Active; empty while Processing/Failed; do not store it as a permanent URL
data.items[].assetType	string	Image, Video, or Audio
data.items[].groupId	string	Platform asset group ID
data.items[].status	string	Processing status: Processing, Active, or Failed
data.items[].assetStatus	integer	Platform enablement: 1 enabled, 2 disabled; separate from processing status
data.items[].createTime	integer	Creation time in Unix seconds
data.items[].updateTime	integer	Update time in Unix seconds
data.items[].remark	string	Platform remark
data.items[].error	object	Failure information, returned only when Failed; contains code and message
data.items[].error.code	string	Stable error code, such as ASSET_PREPARATION_FAILED
data.items[].error.message	string	Localized error message

Response Example

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

The current endpoint rejects the statuses parameter. projectName is not a user API parameter; read processing status from the returned status.