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

查询资产详情

功能介绍

该接口用于查询资产库中指定媒体资产的详情。

调用方法

请参见如何调用API。

URI

GET /v1/{project_id}/digital-assets/{asset_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

asset_id

是

String

资产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。不允许输入中文。

响应参数

状态码： 200

表3 响应Header参数

参数

参数类型

描述

X-Request-Id

String

请求ID。
表4 响应Body参数

参数

参数类型

描述

project_id

String

租户id

asset_id

String

资产ID。

asset_name

String

资产名称。

asset_description

String

资产描述。

app_user_id

String

第三方用户ID。

说明：

  • 即创建资产是通过X-App-UserId头域传入的值。

create_time

String

资产创建时间。

update_time

String

资产更新时间。

asset_type

String

资产类型。

公共资产类型：

  • VOICE_MODEL：音色模型

  • VIDEO：视频文件

  • IMAGE：图片文件

  • PPT：幻灯片文件

  • MUSIC: 音乐

  • AUDIO: 音频

  • COMMON_FILE：通用文件

分身数字人资产类型：

  • HUMAN_MODEL_2D：分身数字人模型

  • BUSINESS_CARD_TEMPLET: 数字人名片模板

3D数字人资产类型：

  • HUMAN_MODEL：3D数字人模型

  • SCENE：场景模型

  • ANIMATION：动作动画

  • MATERIAL：风格化素材

  • NORMAL_MODEL: 普通模型

asset_state

String

资产状态。

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

  • FAILED：主文件上传失败

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

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

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

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

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

  • WAITING_DELETE：资产将被下线

fail_type

String

失败原因。

  • AUTOMATIC_REVIEW_REJECT：自动审核失败

  • MANUAL_REVIEW_REJECT：人工审核失败

默认取值：

AUTOMATIC_REVIEW_REJECT

reason

String

冻结/解冻/失败 原因。

tags

Array of strings

标签列表。

说明：

分身形象系统资产的tag定义如下：

  • 行业：NEWS,BUSINESS,E-COMMERCE,MARKETING,KNOWLEDGE,EDUCATION,SPORTS

  • 性别：MALE,FEMALE

  • 姿势：FULL-BODY,HALF-BODY,STANDING,SITTING,WALKING

  • 区域：ASIAN,WESTERN,MIDDLE-EASTERNER,AFRICAN,LATINO

asset_extra_meta

AssetExtraMeta object

参数解释：

资产额外元数据。

约束限制：

根据asset_type选择对应结构填写，填写其他不匹配的结构会被忽略。

  • HUMAN_MODEL: 填写human_model_meta

  • HUMAN_MODEL_2D: 填写human_model_2d_meta

  • SCENE：填写scene_meta

  • ANIMATION：填写animation_meta

  • MATERIAL：填写material_meta

  • VOICE_MODEL：填写voice_model_meta

  • VIDEO：填写video_meta

  • IMAGE：填写image_meta

  • PPT：填写ppt_meta

  • AUDIO: 填写audio_meta

system_properties

Array of SystemProperty objects

设置系统属性。

files

Array of AssetFileInfo objects

资产下的文件。

asset_order

Integer

展示顺序

取值范围：

0-32767

supported_service

Array of strings

支持的业务类型。：

  • VIDEO_2D：分身数字人视频制作

  • LIVE_2D：分身数字人直播

  • CHAT_2D：分身数字人智能交互
表5 AssetExtraMeta

参数

参数类型

描述

human_model_meta

HumanModelAssetMeta object

数字人模型元数据。

voice_model_meta

VoiceModelAssetMeta object

音色模型元数据。

ppt_meta

PPTAssetMeta object

PPT资产元数据信息。

animation_meta

AnimationAssetMeta object

动作动画资产元数据。

scene_meta

SceneAssetMeta object

场景元数据。

material_meta

MaterialAssetMeta object

素材元数据。

human_model_2d_meta

HumanModel2DAssetMeta object

分身模型元数据

image_meta

ImageAssetMeta object

图片元数据

video_meta

VideoAssetMeta object

视频元数据，自动提取获得。

audio_meta

AudioAssetMeta object

音频元数据，自动提取获得。
表6 HumanModelAssetMeta

参数

参数类型

描述

style_id

String

参数解释：

数字人模型风格ID。

约束限制：

当前仅支持系统提供的几种风格。

取值范围：

  • system_male_001：男性风格01

  • system_female_001：女性风格01

  • system_male_002：男性风格02

  • system_female_002：女性风格02

默认取值：

不涉及

modeling_type

String

参数解释：

数字人模型建模类型。

约束限制：

不涉及

取值范围：

  • UPLOADED：租户上传的模型

  • PICTURE_MODELING：照片建模生成的模型

  • CHARACTER_CUSTOMIZATION_MODELING：捏脸生成的模型

默认取值：

UPLOADED

modeling_job_id

String

参数解释：

建模任务ID。

约束限制：

仅由MetaStudio服务生成的模型系统自行填写

取值范围：

字符长度0-64位。

默认取值：

不涉及。

model_properties

HumanModelMetaProperties object

记录模型配置信息

components

Array of ComponentInfo objects

可替换组件列表。
表7 HumanModelMetaProperties

参数

参数类型

描述

whole_model_base_file_id

String

参数解释：

用于生成WHOLE_MODEL的模型file_id

约束限制：

如果当前记录的信息与MAIN文件的file_id一致，那就认为已经生成过，无需再进行全模型导出

取值范围：

字符长度0-64位。

默认取值：

不涉及。

load_model_file_id

String

参数解释：

当前用于渲染加载的模型file_id

约束限制：

若为空或未匹配到，则使用MAIN文件

取值范围：

字符长度0-64位。

默认取值：

不涉及。
表8 ComponentInfo

参数

参数类型

描述

component_name

String

参数解释：

组件名称。

约束限制：

不涉及。

取值范围：

字符长度1-256位。

默认取值：

不涉及。

component_type

String

参数解释：

组件类型。

约束限制：

不涉及。

取值范围：

字符长度1-256位。

默认取值：

不涉及。

component_desc

String

参数解释：

组件描述。

约束限制：

不涉及。

取值范围：

字符长度0-512位。

默认取值：

不涉及。
表9 VoiceModelAssetMeta

参数

参数类型

描述

order

Integer

参数解释：

展示顺序。

约束限制：

不涉及。

取值范围：

0-32767

默认取值：

999

model_type

String

参数解释：

声音资产类型。

约束限制：

不涉及。

取值范围：

  • COMMON：通用情感模型

  • CLONE：语音克隆模型

默认取值：

CLONE

sex

String

参数解释：

声音性别。

约束限制：

不涉及。

取值范围：

  • UNKNOW：未知性别声音

  • MALE：男性声音

  • FEMALE：女性声音

默认取值：

UNKNOW

language

String

参数解释：

声音语言。

约束限制：

不涉及。

取值范围：

  • UNKNOW：未知

  • CN：中文

  • EN：英文

  • GER：德语

  • fr：法语

  • Kr：韩语

  • por：葡萄牙语

  • JPN：日语

  • Ita：意大利语

  • ESP：西班牙语

  • DBH：东北话

  • GT：港台

  • GXH：广西话

  • HBH：湖北话

  • SXH：陕西话

  • SCH：四川话

  • YY：粤语

  • Russian: 俄罗斯语

  • Filipino: 菲律宾语

  • Dutch: 荷兰语

  • Indonesian: 印尼语

  • Vietnamese: 越南语

  • Arabic: 阿拉伯语

  • Turkish: 土耳其语

  • Malay: 马来语

  • Thai: 泰语

  • Finnish: 芬兰语

默认取值：

UNKNOW

languages

Array of strings

参数解释：

声音语言。

约束限制：

不涉及。

取值范围：

  • UNKNOW：未知

  • CN：中文

  • EN：英文

  • GER：德语

  • fr：法语

  • Kr：韩语

  • por：葡萄牙语

  • JPN：日语

  • Ita：意大利语

  • ESP：西班牙语

  • DBH：东北话

  • GT：港台

  • GXH：广西话

  • HBH：湖北话

  • SXH：陕西话

  • SCH：四川话

  • YY：粤语

  • Russian: 俄罗斯语

  • Filipino: 菲律宾语

  • Dutch: 荷兰语

  • Indonesian: 印尼语

  • Vietnamese: 越南语

  • Arabic: 阿拉伯语

  • Turkish: 土耳其语

  • Malay: 马来语

  • Thai: 泰语

  • Finnish: 芬兰语

speed_ratio

Float

参数解释：

语速缩放比例。

约束限制：

不涉及

取值范围：

0-100

默认取值：

1

volume_ratio

Float

参数解释：

音量缩放比例。

约束限制：

不涉及

取值范围：

0-100

默认取值：

1

is_realtime_voice

Boolean

参数解释：

该音色是否支持实时合成。

约束限制：

支持实时合成的音色，可以用于直播和智能交互场景。否则只能用于视频制作。

取值范围：

  • true: 支持实时合成

  • false: 不支持实时合成

默认取值：

true

style

String

风格参考

voice_capability

VoiceCapability object

音色资产支持的能力集。

说明：

音色能力集只允许查询，不允许设置

external_voice_meta

ExternalVoiceAssetMeta object

第三方TTS音色元数据。

is_support_vc_process

Boolean

是否支持vc。

默认取值：

false

is_flexus

Boolean

是否是Flexus版本声音。

默认取值：

false
表10 VoiceCapability

参数

参数类型

描述

is_support_phoneme_en

Boolean

参数解释：

该声音是否支持英文音标。

约束限制：

不涉及

取值范围：

  • true: 支持英文音标

  • false: 不支持英文音标

默认取值：

false

is_support_phoneme

Boolean

参数解释：

该声音是否支持中文多音字。

约束限制：

不涉及

取值范围：

  • true: 支持中文多音字

  • false: 不支持中文多音字

默认取值：

false

is_support_break_time

Boolean

参数解释：

该声音是否支持停顿。

约束限制：

不涉及

取值范围：

  • true: 支持停顿

  • false: 不支持停顿

默认取值：

false

is_support_break_strength

Boolean

参数解释：

该声音是否支持韵律。

约束限制：

不涉及

取值范围：

  • true: 支持韵律

  • false: 不支持韵律

默认取值：

false

is_support_speed

Boolean

参数解释：

该声音是否支持全局语速。

约束限制：

不涉及

取值范围：

  • true: 支持全局语速

  • false: 不支持全局语速

默认取值：

false

is_support_prosody

Boolean

参数解释：

该声音是否支持局部语速。

约束限制：

不涉及

取值范围：

  • true: 支持局部语速

  • false: 不支持局部语速

默认取值：

false

is_support_ssml_say_as

Boolean

参数解释：

该声音是否支持SSML的say-as标签。

约束限制：

不涉及

取值范围：

  • true: 支持SSML的say-as标签

  • false: 不支持SSML的say-as标签

默认取值：

false

is_support_ssml_sub

Boolean

参数解释：

该声音是否支持SSML的sub标签。

约束限制：

不涉及

取值范围：

  • true: 支持SSML的sub标签

  • false: 不支持SSML的sub标签

默认取值：

false

is_support_word

Boolean

参数解释：

该声音是否支持连读。

约束限制：

不涉及

取值范围：

  • true: 支持连读

  • false: 不支持连读

默认取值：

false

is_support_voice_cache

Boolean

是否支持缓存。

默认取值：

false

conversion_rate

Float

参数解释：

合成率。

约束限制：

不涉及

取值范围：

  • 0-50

取值范围：

0-50

默认取值：

0.0

conversion_rate_en

Float

参数解释：

英语的合成率。

约束限制：

不涉及

取值范围：

  • 0-50

取值范围：

0-50

默认取值：

0.0

is_support_srt

Boolean

是否支持生成STR字幕文件。

默认取值：

false
表11 ExternalVoiceAssetMeta

参数

参数类型

描述

provider

String

第三方TTS供应商类型。

  • XIMALAYA：喜马拉雅TTS

  • HUAWEI_EI：华为云EI TTS

  • MOBVOI：出门问问 TTS

  • AUDIOX：逻辑智能 TTS

  • SINOVOICE：捷通华声 TTS

  • DATABAKER：标贝 TTS

  • AISPEECH：思必驰 TTS
表12 PPTAssetMeta

参数

参数类型

描述

auto_analysis

Boolean

参数解释：

PPT是否需要自动解析。

约束限制：

部分过于复杂的PPT或压缩比过高的PPT可能无法解析。

超过50页PPT仅转换50页

转换的图片无法保证完全还原，需要自行确认。

取值范围：

  • true: 自动解析

  • false: 无需解析

默认取值：

false

ppt_analysis_status

String

参数解释：

PPT解析状态。

约束限制：

不涉及

取值范围：

  • INITIALIZE：初始

  • WAITING：等待

  • CONVERTING：解析中

  • FAILED：失败

  • SUCCEEDED：成功

  • CANCELED：取消

默认取值：

不涉及

error_info

ErrorResponse object

错误信息

page_count

Integer

参数解释：

PPT页面总数。

约束限制：

不涉及

取值范围：

0-256

默认取值：

0

pages

Array of PPTPageInfo objects

PPT页面图片。
表13 PPTPageInfo

参数

参数类型

描述

page_no

Integer

参数解释：

页面编号。

约束限制：

不涉及

取值范围：

1-256

file_id

String

参数解释：

页面对应图片文件ID。

约束限制：

不涉及

取值范围：

字符长度1-64位

默认取值：

不涉及

page_content

String

参数解释：

页面对应图片文件ID

约束限制：

不涉及

取值范围：

字符长度0-2048位

默认取值：

不涉及。
表14 AnimationAssetMeta

参数

参数类型

描述

style_id

String

数字人模型风格ID。

duration

Float

动作动画时长。

取值范围：

0-32767

默认取值：

0

auto_analysis

Boolean

动作是否需要自动解析。

默认取值：

false

voice_delay

Float

语音延迟播放时长。

单位秒。

使用场景举例：入场动画3秒，voice_delay设置成4秒，则语音从入场动画开始后第4秒开始播放。

取值范围：

0-100

默认取值：

0

animation_insert_restriction

String

动画插入位置限制。

  • ONLY_BEGINNING：视频制作时，动画只允许出现在起始位置。

  • ONLY_END：视频制作时，动画只允许出现在结束位置。
表15 SceneAssetMeta

参数

参数类型

描述

components

Array of SceneComponentInfo objects

可操作组件列表（如屏幕，灯光，摄像机）。

default_configs

Map<String,SceneComponentInfo>

默认场景设置（机位，初始人位置）。
表16 SceneComponentInfo

参数

参数类型

描述

index

Integer

组件索引。

取值范围：

1-10

component_name

String

组件名称。

component_type

String

组件类型。

  • CAMERA：摄像机

  • PANEL：屏幕

  • LIGHT：灯光

component_desc

String

组件描述。
表17 MaterialAssetMeta

参数

参数类型

描述

components

Array of MaterialComponentInfo objects

可替换的素材组件列表。
表18 MaterialComponentInfo

参数

参数类型

描述

component_name

String

素材组件名称。

component_type

String

素材组件类型。

  • CLOTHES：衣服

  • PANTS：裤子

  • SHOES：鞋子

  • HAIR：头发

  • EYELASH：睫毛

  • EYEBROW：眉毛

component_desc

String

素材组件描述。
表19 HumanModel2DAssetMeta

参数

参数类型

描述

is_action_editable

Boolean

参数解释：

分身数字人的动作是否可编辑

约束限制：

不涉及

取值范围：

  • true: 动作可编辑

  • false: 动作不可编辑

默认取值：

false

is_real_background

Boolean

参数解释：

是否是实景分身数字人

约束限制：

实景分身数字人不做背景替换。

取值范围：

  • true: 实景分身数字人

  • false: 普通分身数字人，不带背景。

默认取值：

false

support_live

Boolean

参数解释：

是否支持直播

约束限制：

不涉及

取值范围：

  • true: 支持直播

  • false: 不支持直播。

默认取值：

false

model_version

String

参数解释：

分身数字人模型版本

约束限制：

不涉及

取值范围：

  • V2: V2版本模型

  • V3：V3版本模型

  • V3_2：V3.2版本模型

默认取值：

V2

model_resolution

String

参数解释：

分身数字人模型分辨率。

约束限制：

不涉及

取值范围：

  • 1080P：1080P。支持1080P及720P的视频输出。

  • 4K：4K。支持4K、1080P及720P的视频输出。

默认取值：

1080P

device_names

Array of strings

参数解释：

已执行编译任务设备类型列表。

约束限制：

支持走动的数字人，当前仅用于视频制作，不能用于直播和智能交互

取值范围：

设备名称列表最多16个。

设备名称字符长度1-64位。

默认取值：

false

is_with_action_library

Boolean

分身数字人是否带原子动作库。

说明：

  • 带原子动作库的分身数字人可做动作编排。

默认取值：

false

action_tag_map

Array of ActionTagInfo objects

动作标签映射。

is_flexus

Boolean

是否是Flexus版本分身数字人。

默认取值：

false
表20 ActionTagInfo

参数

参数类型

描述

action_name_zh

String

原子动作中文名称。

action_name_en

String

原子动作英文名称。

catalog

String

动作分类名称。

file_name

String

样例视频文件名，最大长度256，最小长度1。

tag

String

动作标签。
表21 ImageAssetMeta

参数

参数类型

描述

codec

String

参数解释：

图片编码格式。

约束限制：

用户无需填写，系统自行提取。

取值范围：

字符长度0-32位。

默认取值：

不涉及。

width

Integer

参数解释：

图片宽度。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及。

取值范围：

0-8196

height

Integer

参数解释：

图片高度。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及。

取值范围：

0-8196

size

Long

参数解释：

图片大小。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及。

取值范围：

0-9223372036854775807

mode

String

参数解释：

图片形态。

约束限制：

用户无需填写，系统自行提取。

取值范围：

  • Horizontal：横向

  • Vertical：纵向

默认取值：

不涉及。

frame_rate

String

参数解释：

视频帧率。

约束限制：

用户无需填写，系统自行提取。

取值范围：

字符长度0-32位。

默认取值：

不涉及

duration

Integer

参数解释：

时长,单位秒。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-86400

error_info

ErrorResponse object

错误信息
表22 VideoAssetMeta

参数

参数类型

描述

video_codec

String

参数解释：

视频编码格式。

约束限制：

用户无需填写，系统自行提取。

取值范围：

字符长度0-32位。

默认取值：

不涉及

width

Integer

参数解释：

视频画面宽度。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-8196

height

Integer

参数解释：

视频画面高度。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-8196

frame_rate

String

参数解释：

视频帧率。

约束限制：

用户无需填写，系统自行提取。

取值范围：

字符长度0-32位。

默认取值：

不涉及

video_bit_rate

Integer

参数解释：

视频平均码率,单位kbps。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-104857600

duration

Integer

参数解释：

时长,单位秒。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-86400

audio_codec

String

参数解释：

音频编码格式。

约束限制：

用户无需填写，系统自行提取。

取值范围：

字符长度0-32位。

默认取值：

不涉及

audio_bit_rate

Integer

参数解释：

音频平均码率,单位kbps。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-16384

audio_channels

Integer

参数解释：

音频声道数。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-100

sample

Integer

参数解释：

采样率,HZ。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-100000

mode

String

参数解释：

横向画面或纵向画面。

约束限制：

用户无需填写，系统自行提取。

取值范围：

  • Horizontal：横向

  • Vertical：纵向

默认取值：

不涉及

video_transcoding_status

String

参数解释：

视频转码状态。

约束限制：

用户无需填写，系统自行填写。

取值范围：

  • WAITING：等待

  • TRANSCODING：转码中

  • FAILED：失败

  • SUCCEEDED：成功

默认取值：

不涉及

error_info

ErrorResponse object

错误信息
表23 AudioAssetMeta

参数

参数类型

描述

duration

Integer

参数解释：

时长,单位秒。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-86400

audio_codec

String

参数解释：

音频编码格式。

约束限制：

用户无需填写，系统自行提取。

取值范围：

字符长度0-32位。

默认取值：

不涉及

audio_bit_rate

Integer

参数解释：

音频平均码率,单位kbps。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-16384

audio_channels

Integer

参数解释：

音频声道数。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-100

sample

Integer

参数解释：

采样率,HZ。

约束限制：

用户无需填写，系统自行提取。

默认取值：

不涉及

取值范围：

0-100000

error_info

ErrorResponse object

错误信息
表24 ErrorResponse

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。
表25 SystemProperty

参数

参数类型

描述

action

String

参数解释：

操作。

约束限制：

系统属性仅为系统设置，普通用户无法修改。

取值范围：

  • ADD：增加

  • DELETE：删除

默认取值：

不涉及

key

String

参数解释：

系统属性条目。

约束限制：

系统属性仅为系统设置，普通用户无法修改。

取值范围：

公共资产属性：

  • BACKGROUND_IMG：视频制作的背景图片。value设置成Yes

  • CREATED_BY_PLATFORM: 是否平台生成。

分身数字人资产属性：

  • MATERIAL_IMG：素材图片，用作图片图层。value设置成Yes，否则控制台视频制作、直播等界面的贴图区域，将无法看到此图片。

  • MATERIAL_VIDEO：素材视频，用作视频图层。value设置成Yes，否则控制台视频制作、直播等界面的视频区域，将无法看到此视频。

  • DIGITAL_HUMAN_2D_VIDEO：分身数字人视频。

  • DIGITAL_HUMAN_3D_VIDEO：3D数字人视频。

  • BUSINESS_CARD_VIDEO：名片视频。

  • BUSSINESS_CARD_VIDEO：名片视频(过期)

  • PHOTO_VIDEO：照片数字人视频。

视频翻译资产属性：

  • TO_BE_TRANSLATED_VIDEO: 视频翻译的源视频。可取值Yes。

  • TRANSLATED_VIDEO: 视频翻译后的视频

3D数字人资产属性：

  • STYLE_ID：风格Id。

  • DH_ID：数字人ID(尚未启用)。

  • PLATFORM_AVAILABLE：是否平台可用(尚未启用)。

  • RENDER_ENGINE：引擎类型。value可选UE或MetaEngine。

  • BACKGROUND_SCENE：视频制作的2D背景场景。value可选Horizontal（横屏）或者Vertical（竖屏）。

  • LAYER_CONFIG_ENABLE: 可用前景图层配置

  • MEITUAN_MATERIAL_APPROVED: 美团平台已审核标识，value设置成YES。

默认取值：

不涉及

value

String

参数解释：

系统属性属性值。

约束限制：

系统属性仅为系统设置，普通用户无法修改。

取值范围：

字符长度1-1024位

默认取值

不涉及
表26 AssetFileInfo

参数

参数类型

描述

file_id

String

文件ID。

file_name

String

文件名创建文件时候不区分大小写，最大长度256，最小长度1。

file_md5

String

文件内容MD5值，固定24位。

file_size

Long

文件总的大小，最小1，最大5368709120。

取值范围：

1-5368709120

file_type

String

文件类型（默认提取文件后缀）。

asset_file_category

String

文件在资产中的分类。每种资产类型包含的文件分类不同。

  • MAIN：主文件

  • COVER：封面文件

  • PAGE：内容页图片

  • SAMPLE：样例音频

  • OTHER：其他文件

  • WHOLE_MODEL：全模型

  • USER_MODIFIED_MODEL：用户上传模型

  • TEMPORARY：临时文件夹（用于文件替换时上传新文件）

  • PACKAGE：打包后的资产文件

说明：

  • 资产类型为SCENE、ANIMATION、VIDEO、IMAGE、MATERIAL时，包含MAIN、COVER和OTHER

  • 资产类型为PPT时，包含MAIN、COVER、PAGE和OTHER

  • 资产类型为HUMAN_MODEL时，包含MAIN、COVER和OTHER

  • 资产类型为VOICE_MODEL时，包含MAIN、SAMPLE(样例音频文件)和OTHER

  • 资产类型为HUMAN_MODEL_2D时，包含MAIN、COVER、SAMPLE(动作样例)和OTHER(遮罩文件)

  • 资产类型为BUSINESS_CARD_TEMPLET时，包含MAIN和COVER(名片效果图)

download_url

String

文件下载URL，有效期为24小时。

state

String

文件状态枚举:

  • CREATING：文件上传中

  • CREATED：文件已上传（自动审核通过）

  • FAILED：文件上传失败

  • CANCELLED：文件上传已取消

  • DELETING：文件删除中

  • DELETED：文件已删除

  • UPLOADED：文件已上传（尚未审核）

  • REVIEW：人工审核（文件已上传）

  • BLOCK：冻结

reason

String

审核失败原因

file_extra_meta

FileExtraMeta object

文件数据。
表27 FileExtraMeta

参数

参数类型

描述

video_transcoding_status

String

视频转码状态。

  • WAITING：等待

  • TRANSCODING：转码中

  • FAILED：失败

  • SUCCEEDED：成功

状态码： 400

表28 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码： 404

表29 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

GET https://{endpoint}/v1/6a6a1f8354f64dd9b9a614def7b59d83/digital-assets/93769b5a-c8c6-4692-9c95-53933a1f0c93

响应示例

状态码： 200

成功。

{
  "asset_id" : "93769b5a-c8c6-4692-9c95-53933a1f0c93",
  "asset_name" : "男教师",
  "asset_description" : "男教师模型",
  "create_time" : "2021-10-30T12:30:35Z",
  "asset_type" : "HUMAN_MODEL",
  "asset_state" : "ACTIVED",
  "files" : [ {
    "file_id" : "24bad716-87b1-45e5-8912-6102f7693265",
    "file_name" : "male001.bin",
    "file_md5" : "38b8c2c1093dd0fec383a9d9ac940515",
    "file_size" : 31032142,
    "file_type" : "bin",
    "asset_file_category" : "MAIN",
    "download_url" : "https://{endpoint}:443/05a8ae5925000fb72f83c0091083231a/ca40212e1cdb64ab5f74446bcddb8eb9/model/image/24bad716-87b1-45e5-8912-6102f7693265.bin?AccessKeyId=F8DE4LGO7EOYY0CM9ERJ&Expires=1657527524&Signature=BWgSQpc4lMFFrtj2ae67fw679%2Bc%3D"
  }, {
    "file_id" : "6dd0c018-7b8e-46aa-8a45-3075c161c500",
    "file_name" : "male001.png",
    "file_md5" : "38b8c2c1093dd0fec383a9d9ac940515",
    "file_size" : 110321,
    "file_type" : "png",
    "asset_file_category" : "COVER",
    "download_url" : "https://{endpoint}:443/05a8ae5925000fb72f83c0091083231a/ca40212e1cdb64ab5f74446bcddb8eb9/model/image/6dd0c018-7b8e-46aa-8a45-3075c161c500.png?AccessKeyId=F8DE4LGO7EOYY0CM9ERJ&Expires=1657527524&Signature=BWgSQpc4lMFFrtj2ae67fw679%2Bc%3D"
  } ]
}

状态码： 400

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

状态码： 404

{
  "error_code" : "MSS.00000002",
  "error_msg" : "Not Found"
}

状态码

状态码

描述

200

成功。

400

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

404

无内容。

错误码

请参见错误码。

父主题： 数字资产管理