Query Asset Detail

GET /api/volc-user/assets/detail

Query detailed information for a specific asset. After creating an asset, poll this endpoint until status = Active before using it in video generation tasks.

Authentication

User console API requiring logged-in user identity (session Cookie, or Authorization: <access_token>, token obtained via Generate Access Token). This token is different from the sk- keys used for model invocation.

⚠️ Asset URLs typically have a 12-hour validity period. Business systems should save the asset ID and retrieve the latest URL via this endpoint, rather than caching URLs long-term.

Query Parameters

Name	Type	Required	Description
id	string	Required	Asset ID

Request Example

GET /api/volc-user/assets/detail?id=asset-a3c92f10

Response Fields (200)

Name	Type	Description
success	boolean	Success flag
message	string	Message
data	object	Asset detail
data.id	string	Asset ID
data.name	string	Asset name
data.url	string	Volcengine asset URL (typically 12-hour validity)
data.assetType	string	Asset type: Image, Video, Audio
data.groupId	string	Asset group ID
data.status	string	Volcengine status: Processing, Active, Failed
data.projectName	string	Volcengine project name
data.createTime	integer	Create time (Unix seconds)
data.updateTime	integer	Update time (Unix seconds)
data.error	object	Error info (when failed)
data.error.code	string	Error code
data.error.message	string	Error description
data.remark	string	Platform remark
data.asset_status	integer	Platform asset status: 1 active, 2 disabled

Response Example

Processing:

{
  "success": true,
  "message": "",
  "data": {
    "id": "asset-a3c92f10",
    "name": "Model Front Image",
    "url": "",
    "assetType": "Image",
    "groupId": "group-7f2b8d9c",
    "status": "Processing",
    "projectName": "default_project",
    "createTime": 1718000000,
    "updateTime": 1718000000,
    "remark": "",
    "asset_status": 1
  }
}

Active:

{
  "success": true,
  "message": "",
  "data": {
    "id": "asset-a3c92f10",
    "name": "Model Front Image",
    "url": "https://example-signed-url.volces.com/xxx",
    "assetType": "Image",
    "groupId": "group-7f2b8d9c",
    "status": "Active",
    "projectName": "default_project",
    "createTime": 1718000000,
    "updateTime": 1718000300,
    "remark": "External asset ID: ext-10001",
    "asset_status": 1
  }
}