查询素材详情

GET /api/volc-user/assets/detail

查询指定素材的详细信息。创建素材后应轮询此接口直到 status = Active 后再用于视频生成任务。

鉴权说明

用户控制台接口，需登录用户身份（会话 Cookie，或 Authorization: <access_token>，令牌由 生成访问令牌 获取）。此令牌与模型调用使用的 sk- 密钥不同。

⚠️ 素材 URL 通常有 12 小时有效期，业务系统应保存素材 ID 并通过本接口换取最新 URL，不应长期缓存 URL。

Query 参数

参数名	类型	必选	说明
id	string	必选	素材 ID

请求示例

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

响应字段（200）

字段名	类型	说明
success	boolean	是否成功
message	string	提示信息
data	object	素材详情
data.id	string	素材 ID
data.name	string	素材名称
data.url	string	火山返回的素材访问 URL（通常有 12 小时有效期）
data.assetType	string	素材类型：Image、Video、Audio
data.groupId	string	素材组 ID
data.status	string	火山状态：Processing（处理中）、Active（可用）、Failed（失败）
data.projectName	string	火山项目名
data.createTime	integer	创建时间（Unix 秒）
data.updateTime	integer	更新时间（Unix 秒）
data.error	object	失败信息（仅失败时返回）
data.error.code	string	错误码
data.error.message	string	错误描述
data.remark	string	平台备注
data.asset_status	integer	平台素材状态：1 正常、2 禁用

响应示例

处理中：

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

可用：

{
  "success": true,
  "message": "",
  "data": {
    "id": "asset-a3c92f10",
    "name": "模特正面图",
    "url": "https://example-signed-url.volces.com/xxx",
    "assetType": "Image",
    "groupId": "group-7f2b8d9c",
    "status": "Active",
    "projectName": "default_project",
    "createTime": 1718000000,
    "updateTime": 1718000300,
    "remark": "第三方业务素材 ID: ext-10001",
    "asset_status": 1
  }
}