查询素材详情
POST
/xmind-cloud-platform/openapi/volcengine?Action=GetAsset&Version=2024-01-01按素材 ID 查询素材详情与入库状态,虚拟素材与真人素材共用本接口。
请求参数
Action 与 Version 通过查询参数传递,其余参数放在 JSON 请求体中。
素材 ID,虚拟素材与真人素材均可。
默认值:-字段与列表一致
返回的字段与 ListAssets 中 Items 的元素完全一致,包含 OneTime。
认证
所有接口使用同一套 V4 签名,凭证与签名方式见火山方舟素材库 API 概览。以下请求头为通用要求:
固定为 application/json。
默认值:application/json实际访问的域名和端口;包含端口时必须写入签名。
默认值:-UTC 时间,格式 yyyyMMdd'T'HHmmss'Z',例如 20261022T131900Z;与平台时间偏差不能超过 300 秒。
默认值:-原始请求体的 SHA-256 小写十六进制。
默认值:-V4 HMAC-SHA256 签名。
默认值:-响应
平台素材 ID。
默认值:-素材名称。
默认值:-预览地址,有效期 1 小时。
默认值:-素材类型:Image、Video、Audio。
默认值:-所属分组 ID。真人素材返回真人分组 ID(group-xxx)。
默认值:-入库状态:Active、Processing、Failed。
默认值:-是否为一次性素材。
默认值:-创建时间,UTC 时间字符串。
默认值:-更新时间,UTC 时间字符串。
默认值:-内容审核信息,通常为 null。
默认值:-最近一次推理时间,通常为 null。
默认值:-Status 为 Failed 时可能包含 Code 与 Message。
默认值:-错误
| Code | 说明 |
|---|---|
400 | InvalidParameter:参数格式或取值非法 |
401 | SignatureDoesNotMatch、InvalidTimestamp、XContentSha256Mismatch、MissingParameter.Authorization 等签名或时间相关错误 |
403 | AccessDenied 凭证被禁用或无权限;ExpiredToken 凭证已过期 |
404 | NotFound.asset_id 素材不存在 |
429 | QuotaWriteQPMExceeded 每分钟写入额度用尽;AccountFlowLimitExceeded 每秒请求上限触发;TooManyRequests 请求过于频繁 |