mingyanmingyan
mingyan

素材详情

获取单个素材的详细信息

GET/kyyReactApiServer/kyyVideo2/asset/{assetId}

Seedance2.0 素材详情

获取单个素材的详细信息,包括素材名称、类型、状态、URL 等。
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

路径参数

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

响应参数

codeinteger
响应状态码
  • 0 - 成功
  • 其他值 - 失败
msgstring
响应消息,成功时为 null,失败时返回错误信息
dataobject
素材详细信息对象

使用场景

查看素材详情

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

验证素材状态

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

获取素材 URL

获取素材的访问地址

素材管理

查看素材的详细属性和创建时间
使用建议:
  • 上传素材后,可以通过此接口查询素材处理状态
  • 在使用素材前,建议先查询确认状态为 Active
  • 可以通过此接口获取素材的最新 URL
最佳实践:
  • 素材上传后,轮询此接口直到状态变为 Active
  • 保存素材 ID,避免重复上传相同素材
  • 定期检查素材状态,确保素材可用