查询真人素材详情

GET /api/volc-user/assets/detail

根据平台素材 ID 查询详情及处理状态；轮询直至 Active 或 Failed。

鉴权说明

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

请求参数

参数名	类型	必选	说明
id	string	必选	Query 参数，平台资源 ID

请求示例

GET /api/volc-user/assets/detail?id=asset-example
Authorization: <access_token>

响应字段（200）

字段名	类型	说明
success	boolean	业务是否成功；HTTP 200 仍需检查此字段
message	string	提示信息，成功时为空字符串
data	object	成功时的响应数据
data.id	string	平台素材 ID，视频生成使用 asset://<id>
data.name	string	素材名称
data.url	string	仅 Active 时展示上游访问 URL；Processing/Failed 时为空字符串，不作为永久地址保存
data.assetType	string	Image、Video、Audio
data.groupId	string	所属平台素材组 ID
data.status	string	处理状态：Processing、Active、Failed
data.assetStatus	integer	平台启用状态：1 正常、2 禁用；与处理状态 status 不同
data.createTime	integer	创建时间，Unix 秒
data.updateTime	integer	更新时间，Unix 秒
data.remark	string	平台备注
data.error	object	仅 Failed 时返回失败信息，包含 code 和 message
data.error.code	string	稳定错误码，例如 ASSET_PREPARATION_FAILED
data.error.message	string	可翻译的错误说明

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "id": "asset-example",
    "name": "本人正面照",
    "url": "https://example.com/approved-portrait.jpg",
    "assetType": "Image",
    "groupId": "group-example",
    "status": "Active",
    "assetStatus": 1,
    "createTime": 1792022440,
    "updateTime": 1792022450,
    "remark": "external-asset-001"
  }
}

视频生成应使用 asset://asset-example 引用平台素材 ID，避免依赖临时访问 URL。Failed 时查看 error；不要将认证会话状态与素材处理状态混用。