跳转到主要内容
GET
/
kyyReactApiServer
/
kyyVideo2
/
asset
/
{assetId}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/asset-20260330142158-q75m8 \
  --header 'Authorization: Bearer {{key}}'
{
  "code": 0,
  "msg": null,
  "data": {
    "name": "猫咪图片",
    "assetId": "asset-20260330142158-q75m8",
    "status": "Active",
    "assetType": "Image",
    "url": "https://example.com/cat.jpg",
    "createTime": "2026-03-30 14:21:58"
  }
}

KyyVideo2 素材详情

获取单个素材的详细信息,包括素材名称、类型、状态、URL 等。

认证

所有请求都需要在请求头中包含 Bearer token:
Authorization: Bearer {{key}}

路径参数

assetId
string
必填
素材 ID,从上传素材接口或素材列表接口获取示例:asset-20260330142158-q75m8

响应参数

code
integer
响应状态码
  • 0 - 成功
  • 其他值 - 失败
msg
string
响应消息,成功时为 null,失败时返回错误信息
data
object
素材详细信息对象

使用场景

查看素材详情

获取素材的完整信息,包括状态和 URL

验证素材状态

检查素材是否已处理完成,可以使用

获取素材 URL

获取素材的访问地址

素材管理

查看素材的详细属性和创建时间
使用建议:
  • 上传素材后,可以通过此接口查询素材处理状态
  • 在使用素材前,建议先查询确认状态为 Active
  • 可以通过此接口获取素材的最新 URL
最佳实践:
  • 素材上传后,轮询此接口直到状态变为 Active
  • 保存素材 ID,避免重复上传相同素材
  • 定期检查素材状态,确保素材可用
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/asset-20260330142158-q75m8 \
  --header 'Authorization: Bearer {{key}}'
{
  "code": 0,
  "msg": null,
  "data": {
    "name": "猫咪图片",
    "assetId": "asset-20260330142158-q75m8",
    "status": "Active",
    "assetType": "Image",
    "url": "https://example.com/cat.jpg",
    "createTime": "2026-03-30 14:21:58"
  }
}