Query Real-Person Asset Detail

GET /api/volc-user/assets/detail

Query details and processing status by platform asset ID; poll until Active or Failed.

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
id	string	Required	Query parameter: platform resource ID

Request Example

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

Response Example

{
  "success": true,
  "message": "",
  "data": {
    "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"
  }
}

Use the platform asset ID as asset://asset-example in video generation instead of depending on a temporary URL. Inspect error when Failed; verification session status and asset processing status are separate.