文档首页/数字内容生产线 MetaStudio/API参考/资产管理/数字资产管理/查询资产概要 - ListAssetSummary
更新时间：2026-01-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询资产概要 - ListAssetSummary

功能介绍

该接口用于查询媒体资产库中指定的多个资产的概要信息。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/digital-assets/summarys

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取。

响应消息头中X-Subject-Token的值。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。

格式为(YYYYMMDD'T'HHMMSS'Z')。

X-App-UserId

否

String

第三方用户ID。不允许输入中文。

表3 请求Body参数

参数

是否必选

参数类型

描述

asset_ids

是

Array of strings

需要查询的资产ID。

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

请求ID。

表5 响应Body参数

参数

参数类型

描述

asset_list

Array of DigitalAssetSummary objects

资产列表。

表6 DigitalAssetSummary

参数

参数类型

描述

asset_id

String

资产ID。

asset_name

String

资产名称。

asset_state

String

资产状态。

  • CREATING：资产创建中，主文件尚未上传

  • FAILED：主文件上传失败

  • UNACTIVED：主文件上传成功，资产未激活，资产不可用于其他业务（用户可更新状态）

  • ACTIVED：主文件上传成功，资产激活，资产可用于其他业务（用户可更新状态）

  • DELETING：资产删除中，资产不可用，资产可恢复

  • DELETED：资产文件已删除，资产不可用，资产不可恢复

  • BLOCK: 资产被冻结，资产不可用，不可查看文件。

  • WAITING_DELETE：资产将被下线

asset_type

String

资产类型。

公共资产类型：

  • VOICE_MODEL：音色模型（仅系统管理员可上传，普通租户仅可查询）

  • VIDEO：视频文件

  • IMAGE：图片文件

  • PPT：幻灯片文件

  • MUSIC: 音乐

  • AUDIO: 音频

  • COMMON_FILE：通用文件

分身数字人资产：

  • HUMAN_MODEL_2D: 分身数字人模型

  • BUSINESS_CARD_TEMPLET: 数字人名片模板

block_reason_code

String

冻结原因编号。

cover_url

String

封面图片路径。

thumbnail_url

String

缩略图路径。

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

POST https://{endpoint}/v1/6a6a1f8354f64dd9b9a614def7b59d83/digital-assets/summarys

{
  "asset_ids" : [ "8cb2f48a2cb006154794741933421100", "e2ba8314ebaab34d368711d118fcecba" ]
}

响应示例

状态码：200

成功。

{
  "asset_list" : [ {
    "asset_id" : "93769b5a-c8c6-4692-9c95-53933a1f0c93",
    "asset_name" : "男教师",
    "asset_type" : "HUMAN_MODEL_2D",
    "cover_url" : "https://{endpoint}:443/05a8ae5925000fb72f83c0091083231a/ca40212e1cdb64ab5f74446bcddb8eb9/model/image/6dd0c018-7b8e-46aa-8a45-3075c161c500.png?AccessKeyId=**************&Expires=1657527524&Signature=**************"
  } ]
}

状态码：400

请求传参异常，包含错误码及对应描述。

{
  "error_code" : "MSS.00000003",
  "error_msg" : "Invalid parameter"
}

状态码

状态码

描述

200

成功。

400

请求传参异常，包含错误码及对应描述。

错误码

请参见错误码。

父主题： 数字资产管理