Help Center/ MetaStudio/ API Reference/ Asset Management/ Digital Asset Management/ Updating an Asset

Updated on 2025-12-08 GMT+08:00

Online Debugging

CLI Examples

View PDF

Updating an Asset

Function

You can update media asset information in the asset library.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
asset_id	Yes	String	Asset ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	User token. This parameter is mandatory when token authentication is used. You can obtain the token by calling the IAM API used to obtain a user token. Value of X-Subject-Token in the response header.
Authorization	No	String	Authentication information. This parameter is mandatory for AK/SK authentication.
X-Sdk-Date	No	String	Time when the request is sent. This parameter is mandatory for AK/SK authentication. The format is YYYYMMDD'T'HHMMSS'Z'.
X-App-UserId	No	String	Third-party user ID, which does not allow Chinese characters.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
asset_name	No	String	Details: Asset name. Constraints: N/A Options: The value contains 0 to 256 characters. Default value: N/A
asset_description	No	String	Details: Asset description. Constraints: N/A Options: The value contains 0 to 4,096 characters. Default value: N/A
asset_type	No	String	Definition Asset type. Constraints VOICE_MODEL and HUMAN_MODEL_2D are not available for common users. Range Public asset type. Options: VOICE_MODEL: timbre model VIDEO: video file IMAGE: image file PPT: PowerPoint file MUSIC: music AUDIO: audio COMMON_FILE: common file Virtual avatar asset. Options: HUMAN_MODEL_2D: virtual avatar model BUSINESS_CARD_TEMPLATE: virtual avatar business card template Default Value N/A
asset_state	No	String	Details: Asset status. Constraints: Tenants can only activate or deactivate assets. Other statuses are automatically updated. Options: UNACTIVED: deactivated. Unactivated assets cannot be used for other services. ACTIVED: activated. Activated assets can be used for other services. WAITING_DELETE: The asset will be taken offline. (Activated assets are available for the administrator.) Default value: N/A
review_config	No	ReviewConfig object	Configures content review.
tags	No	Array of strings	Details: Tags. NOTE: Avatar system asset tag definition: Field: NEWS, BUSINESS, E-COMMERCE, MARKETING, KNOWLEDGE, EDUCATION, SPORTS Gender: MALE, FEMALE Posture: FULL-BODY, HALF-BODY, STANDING, SITTING, WALKING Region: ASIAN, WESTERN, MIDDLE-EASTERNER, AFRICAN, LATINO Constraints: N/A Options: A maximum of 50 tags are allowed. A tag contains 0 to 128 characters. Default value: N/A
asset_extra_meta	No	AssetExtraMeta object	Definition Additional asset metadata. Constraints Select a structure based on asset_type. Other unmatched structures will be ignored. HUMAN_MODEL_2D: Enter human_model_2d_meta. MATERIAL: Enter material_meta. VOICE_MODEL: Enter voice_model_meta. VIDEO: Enter video_meta. IMAGE: Enter image_meta. PPT: Enter ppt_meta. AUDIO: Enter audio_meta.
system_properties	No	Array of SystemProperty objects	Sets system attributes.
shared_config	No	AssetSharedConfig object	Sharing configuration
asset_order	No	Integer	Details: Specifies the display sequence on the console. If the values are the same, the latest value is placed in the front by default. Constraints: N/A Default value: N/A Value range: 0~32767
supported_service	No	Array of strings	Supported service type. Options: VIDEO_2D: virtual avatar video production LIVE_2D: virtual avatar livestreaming CHAT_2D: virtual avatar intelligent interaction
auto_operation_config	No	Array of AutoOperationConfig objects	Auto asset handling task.

**Table 4** ReviewConfig
Parameter	Mandatory	Type	Description
no_need_review	No	Boolean	Content review whitelist. This feature is available only for users in the whitelist. The auto review policies apply to other users.

**Table 5** AssetExtraMeta
Parameter	Mandatory	Type	Description
voice_model_meta	No	VoiceModelAssetMeta object	Timbre model metadata.
ppt_meta	No	PPTAssetMeta object	PPT asset metadata information.
material_meta	No	MaterialAssetMeta object	Material metadata.
human_model_2d_meta	No	HumanModel2DAssetMeta object	Virtual avatar model metadata
image_meta	No	ImageAssetMeta object	Image metadata
video_meta	No	VideoAssetMeta object	Video metadata, which is automatically extracted.
audio_meta	No	AudioAssetMeta object	Audio metadata, which is automatically extracted.

**Table 6** VoiceModelAssetMeta
Parameter	Mandatory	Type	Description
order	No	Integer	Details: Display order. Constraints: N/A Value range: 0~32767 Default value: 999
model_type	No	String	Details: Voice asset type. Constraints: N/A Options: COMMON: general emotion model CLONE: voice cloning model Default value: CLONE
sex	No	String	Details: Voice gender. Constraints: N/A Options: UNKNOW: voice of an unknown gender MALE: male voice FEMALE: female voice Default value: UNKNOW
language	No	String	Details: Voice language. Constraints: N/A Options: UNKNOW: unknown CN: Chinese EN: English GER: German fr: French Kr: Korean por: Portuguese JPN: Japanese Ita: Italian ESP: Spanish DBH: Northeast China dialect GT: Hong Kong & Taiwan dialect GXH: Guangxi dialect HBH: Hubei dialect SXH: Shaanxi dialect SCH: Sichuan dialect YY: Cantonese Russian: Russian Filipino: Tagalog Dutch: Dutch Indonesian: Indonesian Vietnamese: Vietnamese Arabic: Arabic Turkish: Turkish Malay: Malay Thai: Thai Finnish: Finnish Default value: UNKNOW
languages	No	Array of strings	Definition Voice language. Constraints N/A Range UNKNOW: unknown CN: Chinese EN: English GER: German fr: French Kr: Korean por: Portuguese JPN: Japanese Ita: Italian ESP: Spanish DBH: Northeast China dialect GT: Hong Kong & Taiwan dialect GXH: Guangxi dialect HBH: Hubei dialect SXH: Shaanxi dialect SCH: Sichuan dialect YY: Cantonese Russian: Russian Filipino: Tagalog Dutch: Dutch Indonesian: Indonesian Vietnamese: Vietnamese Arabic: Arabic Turkish: Turkish Malay: Malay Thai: Thai Finnish: Finnish
speed_ratio	No	Float	Details: Speaking speed zoom ratio. Constraints: N/A Value range: 0~100 Default value: 1
volume_ratio	No	Float	Details: Volume zoom ratio. Constraints: N/A Value range: 0~100 Default value: 1
is_realtime_voice	No	Boolean	Details: Whether the timbre supports real-time synthesis. Constraints: Timbre that supports real-time synthesis can be used for livestreaming and intelligent interaction. Timbre that does not support real-time synthesis can only be used for video production. Options: true: Real-time synthesis is supported. false: Real-time synthesis is not supported. Default value: true
style	No	String	Style reference
voice_capability	No	VoiceCapability object	Capability set supported by the timbre asset. NOTE: The timbre capability set can be queried but cannot be configured.
external_voice_meta	No	ExternalVoiceAssetMeta object	Third-party TTS timbre metadata.
is_support_vc_process	No	Boolean	Whether VC is supported. Default value: false
is_support_thai_auto_split	No	Boolean	Whether auto text splitting is supported for Thai. Default value: false
is_flexus	No	Boolean	Whether the voice is of the Flexus edition. Default value: false
is_enhance_rhythm	No	Boolean	Whether to enhance rhythm. Default value: false
age	No	String	Timbre age groups: young, middle-aged, and elderly

**Table 7** VoiceCapability
Parameter	Mandatory	Type	Description
is_support_phoneme_en	No	Boolean	Details: Whether the voice supports English phonetics. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_phoneme	No	Boolean	Details: Whether the voice supports Chinese multi-pronunciation words. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_break_time	No	Boolean	Details: Whether the voice supports pauses. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_break_strength	No	Boolean	Details: Whether the voice supports rhythm. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_speed	No	Boolean	Details: Whether the voice supports global speaking speed. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_prosody	No	Boolean	Details: Whether the voice supports local speaking speed. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_ssml_say_as	No	Boolean	Details: Whether the voice supports say-as SSML tags. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_ssml_sub	No	Boolean	Details: Whether the voice supports sub SSML tags. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_word	No	Boolean	Details: Whether the voice supports continuous reading. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_voice_cache	No	Boolean	Whether cache is supported. Default value: false
conversion_rate	No	Float	Details: Synthesis rate. Constraints: N/A Options: 0-50 Value range: 0~50 Default value: 0.0
conversion_rate_en	No	Float	Details: Synthesis rate of English. Constraints: N/A Options: 0–50 Value range: 0~50 Default value: 0.0
is_support_srt	No	Boolean	Whether STR subtitle files can be generated. Default value: false

**Table 8** ExternalVoiceAssetMeta
Parameter	Mandatory	Type	Description
provider	Yes	String	Third-party TTS vendor. Options: XIMALAYA: Himalaya TTS HUAWEI_EI: Huawei Cloud EI TTS MOBVOI: DupDub TTS AUDIOX: AudioX TTS SINOVOICE: SinoVoice TTS DATABAKER: Databaker TTS AISPEECH: AISpeech TTS

**Table 9** PPTAssetMeta
Parameter	Mandatory	Type	Description
auto_analysis	No	Boolean	Details: Whether the PowerPoint file needs to be automatically parsed. Constraints: Parsing some complex PowerPoint files or PowerPoint files with a high compression ratio may fail. If the PowerPoint file contains more than 50 pages, only the first 50 pages will be converted. The converted images may not be completely restored. You need to confirm the restoration result. Options: true: automatic parsing false: automatic parsing not required Default value: false
ppt_analysis_status	No	String	Details: PowerPoint file parsing status. Constraints: N/A Options: INITIALIZE: initial WAITING: waiting for parsing CONVERTING: parsing... FAILED: failed SUCCEEDED: succeeded CANCELED: canceled Default value: N/A
error_info	No	ErrorResponse object	Error information
page_count	No	Integer	Details: Total number of PowerPoint pages. Constraints: N/A Value range: 0~256 Default value: 0
pages	No	Array of PPTPageInfo objects	PPT page image.

**Table 10** PPTPageInfo
Parameter	Mandatory	Type	Description
page_no	No	Integer	Details: Page number. Constraints: N/A Value range: 1~256
file_id	No	String	Details: ID of the image file of a specified page. Constraints: N/A Options: The value contains 1 to 64 characters. Default value: N/A
page_content	No	String	Details: ID of the image file of a specified page Constraints: N/A Options: The value contains 0 to 2,048 characters. Default value: N/A

**Table 11** MaterialAssetMeta
Parameter	Mandatory	Type	Description
components	No	Array of MaterialComponentInfo objects	Replaceable material components.

**Table 12** MaterialComponentInfo
Parameter	Mandatory	Type	Description
component_name	Yes	String	Material component name.
component_type	Yes	String	Material component type. CLOTHES: clothes PANTS: pants SHOES: shoes HAIR: hair EYELASH: eyelashes EYEBROW: eyebrows
component_desc	No	String	Material component description.

**Table 13** HumanModel2DAssetMeta
Parameter	Mandatory	Type	Description
is_action_editable	No	Boolean	Details: Whether the actions of a virtual avatar can be edited. Constraints: N/A Options: true: editable false: not editable Default value: false
is_live_copy	No	Boolean	Definition Whether it is a task for training a livestream-based avatar. Constraints N/A Range true: yes false: no Default value: false
is_real_background	No	Boolean	Details: Whether it is a real-scene virtual avatar. Constraints: If yes, the background does not need to be changed. Options: true: real-scene virtual avatar false: general virtual avatar without background Default value: false
support_live	No	Boolean	Details: Whether livestreaming is supported. Constraints: N/A Options: true: supported false: unsupported Default value: false
model_version	No	String	Definition Virtual avatar model version. Constraints N/A Range V2: V2 model V3: V3 model V3_2: V3.2 model V3_3: V3.3 model Default value: V2
model_resolution	No	String	Details: Virtual avatar model resolution. Constraints: N/A Options: 1080P: 1080p. 1080p or 720p video can be output. 4K: 4K. 4K, 1080p, or 720p video can be output. Default value: 1080P
device_names	No	Array of strings	Details: Devices for which compilation tasks have been executed. Constraints: Walking virtual avatars can be used only for video production. Options: A maximum of 16 device names are allowed. A device name contains 1 to 64 characters. Default value: false
is_with_action_library	No	Boolean	Whether the virtual avatar has an atomic action library. NOTE: A virtual avatar with an atomic action library supports choreography. Default value: false
action_tag_map	No	Array of ActionTagInfo objects	Action tag mapping.
is_flexus	No	Boolean	Whether it is a Flexus virtual avatar. Default value: false
voice_asset_id	No	String	ID of the voice asset associated with the virtual avatar.

**Table 14** ActionTagInfo
Parameter	Mandatory	Type	Description
action_name_zh	Yes	String	Atomic action name in Chinese.
action_name_en	Yes	String	Atomic action name in English.
action_duration	No	Float	Action duration. Value range: 0~100
catalog	No	String	Action category name.
file_name	No	String	Sample video file name. The value contains 1 to 256 characters.
tag	No	String	Action tag.

**Table 15** ImageAssetMeta
Parameter	Mandatory	Type	Description
codec	No	String	Details: Image encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
width	No	Integer	Details: Image width. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
height	No	Integer	Details: Image height. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
size	No	Long	Details: Image size. Constraints: Automatically extracted. Default value: N/A Value range: 0~9223372036854775807
mode	No	String	Details: Image form. Constraints: Automatically extracted. Options: Horizontal: horizontal Vertical: vertical Default value: N/A
frame_rate	No	String	Definition Video frame rate. Constraints Automatically extracted. Range The value contains 0 to 32 characters. Default Value N/A
duration	No	Integer	Definition Duration, in seconds. Constraints Automatically extracted. Default Value N/A Value range: 0~86400
error_info	No	ErrorResponse object	Error message

**Table 16** VideoAssetMeta
Parameter	Mandatory	Type	Description
video_codec	No	String	Details: Video encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
width	No	Integer	Details: Video image width. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
height	No	Integer	Details: Video height. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
frame_rate	No	String	Details: Video frame rate. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
video_bit_rate	No	Integer	Details: Average video bitrate, in kbit/s. Constraints: Automatically extracted. Default value: N/A Value range: 0~104857600
duration	No	Integer	Details: Duration, in second. Constraints: Automatically extracted. Default value: N/A Value range: 0~86400
audio_codec	No	String	Details: Audio encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
audio_bit_rate	No	Integer	Details: Average audio bitrate, in kbit/s. Constraints: Automatically extracted. Default value: N/A Value range: 0~16384
audio_channels	No	Integer	Details: Number of audio channels. Constraints: Automatically extracted. Default value: N/A Value range: 0~100
sample	No	Integer	Details: Sampling rate, in Hz. Constraints: Automatically extracted. Default value: N/A Value range: 0~100000
mode	No	String	Details: Horizontal or vertical display. Constraints: Automatically extracted. Options: Horizontal: horizontal Vertical: vertical Default value: N/A
video_transcoding_status	No	String	Details: Video transcoding status. Constraints: Automatically filled. Options: WAITING: waiting for transcoding TRANSCODING: transcoding... FAILED: failed SUCCEEDED: succeeded Default value: N/A
error_info	No	ErrorResponse object	Error message

**Table 17** AudioAssetMeta
Parameter	Mandatory	Type	Description
duration	No	Integer	Details: Duration, in second. Constraints: Automatically extracted. Default value: N/A Value range: 0~86400
audio_codec	No	String	Details: Audio encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
audio_bit_rate	No	Integer	Details: Average audio bitrate, in kbit/s. Constraints: Automatically extracted. Default value: N/A Value range: 0~16384
audio_channels	No	Integer	Details: Number of audio channels. Constraints: Automatically extracted. Default value: N/A Value range: 0~100
sample	No	Integer	Details: Sampling rate, in Hz. Constraints: Automatically extracted. Default value: N/A Value range: 0~100000
error_info	No	ErrorResponse object	Error message

**Table 18** ErrorResponse
Parameter	Mandatory	Type	Description
error_code	No	String	Error code.
error_msg	No	String	Error description.

**Table 19** SystemProperty
Parameter	Mandatory	Type	Description
action	No	String	Details: Operation. Constraints: System properties cannot be modified by common users. Options: ADD: adding DELETE: deleting Default value: N/A
key	No	String	Definition System properties. Constraints System properties cannot be modified by common users. Range Public asset property: BACKGROUND_IMG: 2D background image for video production. Set value to Yes. CREATED_BY_PLATFORM: whether it is generated by the platform BACKGROUND_SCENE: 2D background scene for video production. Set value to Horizontal or Vertical. MEITUAN_MATERIAL_APPROVED: whether the asset is approved by Meituan. Set value to YES. IS_CONTROLLED: whether the asset is controlled. This parameter is used only for image and voice assets. The value can be Yes. LIVE_IS_AUTHORIZED: whether livestreaming is authorized. This parameter is used only for image and voice assets. The value can be Yes. VIDEO_IS_AUTHORIZED: whether the video production service is authorized. This parameter is used only for image and voice assets. The value can be Yes. CHAT_IS_AUTHORIZED: whether the intelligent interaction service is authorized. This parameter is used only for image and voice assets. The value can be Yes. Virtual avatar asset property: MATERIAL_IMG: image, which is used as an overlay Set value to Yes. Otherwise, the image cannot be displayed in the image overlay area on the video production and livestreaming pages of the console. MATERIAL_VIDEO: video, which is used as an overlay Set value to Yes. Otherwise, the video cannot be displayed in the video overlay area on the video production and livestreaming pages of the console. DIGITAL_HUMAN_2D_VIDEO: virtual avatar video BUSINESS_CARD_VIDEO: business card video BUSSINESS_CARD_VIDEO: business card video (expired) PHOTO_VIDEO: photo-based virtual avatar video Default Value N/A
value	No	String	Details: System attribute value. Constraints: System properties cannot be modified by common users. Options: The value contains 1 to 1,024 characters. Default value: N/A

**Table 20** AssetSharedConfig
Parameter	Mandatory	Type	Description
shared_type	No	String	Sharing type. PRIVATE: accessible only to the current tenant PUBLIC: accessible to all tenants. Currently, only system assets are accessible to all tenants. SHARED: accessible to specified tenants, who are specified by the owner.
expire_time	No	String	Time when the sharing expires. The default value is 30 days, that is, 23:59:59 on the day when sharing starts plus 30 days.
allowed_project_ids	No	Array of strings	Tenants allowed to access the asset.

**Table 21** AutoOperationConfig
Parameter	Mandatory	Type	Description
operation	No	String	BLOCK: frozen DELETE: deleting
operation_time	No	String	Resource expiration time. The format complies with RFC 3339, for example, 2025-01-10T00:00:00Z.

Response Parameters

Status code: 200

**Table 22** Response header parameters
Parameter	Type	Description
X-Request-Id	String	Request ID.

**Table 23** Response body parameters
Parameter	Type	Description
project_id	String	Tenant ID
asset_id	String	Asset ID.
produce_id	String	AI identifier.
asset_name	String	Asset name.
asset_description	String	Asset description.
app_user_id	String	Third-party user ID. NOTE: An asset is created by specifying the value of the X-App-UserId header.
create_time	String	Time when an asset is created.
update_time	String	Time when an asset is updated.
asset_type	String	Asset type. Public asset type. Options: VOICE_MODEL: timbre model VIDEO: video file IMAGE: image file PPT: PowerPoint file MUSIC: music AUDIO: audio COMMON_FILE: common file Virtual avatar asset type. Options: HUMAN_MODEL_2D: virtual avatar model BUSINESS_CARD_TEMPLATE: virtual avatar business card template
asset_state	String	Asset status. CREATING: The asset is being created. The main file has not been uploaded. FAILED: Main file upload failed. UNACTIVED: The main file has been uploaded. The asset is not activated and cannot be used for other services. (Users can update the status.) ACTIVED: The main file has been uploaded. The asset is activated and can be used for other services. (Users can update the status.) DELETING: The asset is being deleted. The asset is unavailable but can be restored. DELETED: The asset has been deleted. The asset is unavailable and cannot be restored. BLOCK: The asset has been frozen. The asset is unavailable and cannot be viewed. WAITING_DELETE: The asset will be taken offline.
fail_type	String	Failure causes: AUTOMATIC_REVIEW_REJECT: Auto review failed. MANUAL_REVIEW_REJECT: Manual review failed.
block_reason_code	String	Reason number for freezing.
reason	String	Freezing, unfreezing, and failure causes.
tags	Array of strings	Tags. NOTE: Avatar system asset tag definition: Field: NEWS, BUSINESS, E-COMMERCE, MARKETING, KNOWLEDGE, EDUCATION, SPORTS Gender: MALE, FEMALE Posture: FULL-BODY, HALF-BODY, STANDING, SITTING, WALKING Region: ASIAN, WESTERN, MIDDLE-EASTERNER, AFRICAN, LATINO
asset_extra_meta	AssetExtraMeta object	Definition Additional asset metadata. Constraints Select a structure based on asset_type. Other unmatched structures will be ignored. HUMAN_MODEL_2D: Enter human_model_2d_meta. MATERIAL: Enter material_meta. VOICE_MODEL: Enter voice_model_meta. VIDEO: Enter video_meta. IMAGE: Enter image_meta. PPT: Enter ppt_meta. AUDIO: Enter audio_meta.
system_properties	Array of SystemProperty objects	Sets system attributes.
files	Array of AssetFileInfo objects	Files under an asset.
asset_order	Integer	Display order Value range: 0~32767
supported_service	Array of strings	Supported service type. Options: VIDEO_2D: virtual avatar video production LIVE_2D: virtual avatar livestreaming CHAT_2D: virtual avatar intelligent interaction
auto_operation_config	Array of AutoOperationConfig objects	Auto asset handling task.

**Table 24** AssetExtraMeta
Parameter	Type	Description
voice_model_meta	VoiceModelAssetMeta object	Timbre model metadata.
ppt_meta	PPTAssetMeta object	PPT asset metadata information.
material_meta	MaterialAssetMeta object	Material metadata.
human_model_2d_meta	HumanModel2DAssetMeta object	Virtual avatar model metadata
image_meta	ImageAssetMeta object	Image metadata
video_meta	VideoAssetMeta object	Video metadata, which is automatically extracted.
audio_meta	AudioAssetMeta object	Audio metadata, which is automatically extracted.

**Table 25** VoiceModelAssetMeta
Parameter	Type	Description
order	Integer	Details: Display order. Constraints: N/A Value range: 0~32767 Default value: 999
model_type	String	Details: Voice asset type. Constraints: N/A Options: COMMON: general emotion model CLONE: voice cloning model Default value: CLONE
sex	String	Details: Voice gender. Constraints: N/A Options: UNKNOW: voice of an unknown gender MALE: male voice FEMALE: female voice Default value: UNKNOW
language	String	Details: Voice language. Constraints: N/A Options: UNKNOW: unknown CN: Chinese EN: English GER: German fr: French Kr: Korean por: Portuguese JPN: Japanese Ita: Italian ESP: Spanish DBH: Northeast China dialect GT: Hong Kong & Taiwan dialect GXH: Guangxi dialect HBH: Hubei dialect SXH: Shaanxi dialect SCH: Sichuan dialect YY: Cantonese Russian: Russian Filipino: Tagalog Dutch: Dutch Indonesian: Indonesian Vietnamese: Vietnamese Arabic: Arabic Turkish: Turkish Malay: Malay Thai: Thai Finnish: Finnish Default value: UNKNOW
languages	Array of strings	Definition Voice language. Constraints N/A Range UNKNOW: unknown CN: Chinese EN: English GER: German fr: French Kr: Korean por: Portuguese JPN: Japanese Ita: Italian ESP: Spanish DBH: Northeast China dialect GT: Hong Kong & Taiwan dialect GXH: Guangxi dialect HBH: Hubei dialect SXH: Shaanxi dialect SCH: Sichuan dialect YY: Cantonese Russian: Russian Filipino: Tagalog Dutch: Dutch Indonesian: Indonesian Vietnamese: Vietnamese Arabic: Arabic Turkish: Turkish Malay: Malay Thai: Thai Finnish: Finnish
speed_ratio	Float	Details: Speaking speed zoom ratio. Constraints: N/A Value range: 0~100 Default value: 1
volume_ratio	Float	Details: Volume zoom ratio. Constraints: N/A Value range: 0~100 Default value: 1
is_realtime_voice	Boolean	Details: Whether the timbre supports real-time synthesis. Constraints: Timbre that supports real-time synthesis can be used for livestreaming and intelligent interaction. Timbre that does not support real-time synthesis can only be used for video production. Options: true: Real-time synthesis is supported. false: Real-time synthesis is not supported. Default value: true
style	String	Style reference
voice_capability	VoiceCapability object	Capability set supported by the timbre asset. NOTE: The timbre capability set can be queried but cannot be configured.
external_voice_meta	ExternalVoiceAssetMeta object	Third-party TTS timbre metadata.
is_support_vc_process	Boolean	Whether VC is supported. Default value: false
is_support_thai_auto_split	Boolean	Whether auto text splitting is supported for Thai. Default value: false
is_flexus	Boolean	Whether the voice is of the Flexus edition. Default value: false
is_enhance_rhythm	Boolean	Whether to enhance rhythm. Default value: false
age	String	Timbre age groups: young, middle-aged, and elderly

**Table 26** VoiceCapability
Parameter	Type	Description
is_support_phoneme_en	Boolean	Details: Whether the voice supports English phonetics. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_phoneme	Boolean	Details: Whether the voice supports Chinese multi-pronunciation words. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_break_time	Boolean	Details: Whether the voice supports pauses. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_break_strength	Boolean	Details: Whether the voice supports rhythm. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_speed	Boolean	Details: Whether the voice supports global speaking speed. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_prosody	Boolean	Details: Whether the voice supports local speaking speed. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_ssml_say_as	Boolean	Details: Whether the voice supports say-as SSML tags. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_ssml_sub	Boolean	Details: Whether the voice supports sub SSML tags. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_word	Boolean	Details: Whether the voice supports continuous reading. Constraints: N/A Options: true: supported false: unsupported Default value: false
is_support_voice_cache	Boolean	Whether cache is supported. Default value: false
conversion_rate	Float	Details: Synthesis rate. Constraints: N/A Options: 0-50 Value range: 0~50 Default value: 0.0
conversion_rate_en	Float	Details: Synthesis rate of English. Constraints: N/A Options: 0–50 Value range: 0~50 Default value: 0.0
is_support_srt	Boolean	Whether STR subtitle files can be generated. Default value: false

**Table 27** ExternalVoiceAssetMeta
Parameter	Type	Description
provider	String	Third-party TTS vendor. Options: XIMALAYA: Himalaya TTS HUAWEI_EI: Huawei Cloud EI TTS MOBVOI: DupDub TTS AUDIOX: AudioX TTS SINOVOICE: SinoVoice TTS DATABAKER: Databaker TTS AISPEECH: AISpeech TTS

**Table 28** PPTAssetMeta
Parameter	Type	Description
auto_analysis	Boolean	Details: Whether the PowerPoint file needs to be automatically parsed. Constraints: Parsing some complex PowerPoint files or PowerPoint files with a high compression ratio may fail. If the PowerPoint file contains more than 50 pages, only the first 50 pages will be converted. The converted images may not be completely restored. You need to confirm the restoration result. Options: true: automatic parsing false: automatic parsing not required Default value: false
ppt_analysis_status	String	Details: PowerPoint file parsing status. Constraints: N/A Options: INITIALIZE: initial WAITING: waiting for parsing CONVERTING: parsing... FAILED: failed SUCCEEDED: succeeded CANCELED: canceled Default value: N/A
error_info	ErrorResponse object	Error information
page_count	Integer	Details: Total number of PowerPoint pages. Constraints: N/A Value range: 0~256 Default value: 0
pages	Array of PPTPageInfo objects	PPT page image.

**Table 29** PPTPageInfo
Parameter	Type	Description
page_no	Integer	Details: Page number. Constraints: N/A Value range: 1~256
file_id	String	Details: ID of the image file of a specified page. Constraints: N/A Options: The value contains 1 to 64 characters. Default value: N/A
page_content	String	Details: ID of the image file of a specified page Constraints: N/A Options: The value contains 0 to 2,048 characters. Default value: N/A

**Table 30** MaterialAssetMeta
Parameter	Type	Description
components	Array of MaterialComponentInfo objects	Replaceable material components.

**Table 31** MaterialComponentInfo
Parameter	Type	Description
component_name	String	Material component name.
component_type	String	Material component type. CLOTHES: clothes PANTS: pants SHOES: shoes HAIR: hair EYELASH: eyelashes EYEBROW: eyebrows
component_desc	String	Material component description.

**Table 32** HumanModel2DAssetMeta
Parameter	Type	Description
is_action_editable	Boolean	Details: Whether the actions of a virtual avatar can be edited. Constraints: N/A Options: true: editable false: not editable Default value: false
is_live_copy	Boolean	Definition Whether it is a task for training a livestream-based avatar. Constraints N/A Range true: yes false: no Default value: false
is_real_background	Boolean	Details: Whether it is a real-scene virtual avatar. Constraints: If yes, the background does not need to be changed. Options: true: real-scene virtual avatar false: general virtual avatar without background Default value: false
support_live	Boolean	Details: Whether livestreaming is supported. Constraints: N/A Options: true: supported false: unsupported Default value: false
model_version	String	Definition Virtual avatar model version. Constraints N/A Range V2: V2 model V3: V3 model V3_2: V3.2 model V3_3: V3.3 model Default value: V2
model_resolution	String	Details: Virtual avatar model resolution. Constraints: N/A Options: 1080P: 1080p. 1080p or 720p video can be output. 4K: 4K. 4K, 1080p, or 720p video can be output. Default value: 1080P
device_names	Array of strings	Details: Devices for which compilation tasks have been executed. Constraints: Walking virtual avatars can be used only for video production. Options: A maximum of 16 device names are allowed. A device name contains 1 to 64 characters. Default value: false
is_with_action_library	Boolean	Whether the virtual avatar has an atomic action library. NOTE: A virtual avatar with an atomic action library supports choreography. Default value: false
action_tag_map	Array of ActionTagInfo objects	Action tag mapping.
is_flexus	Boolean	Whether it is a Flexus virtual avatar. Default value: false
voice_asset_id	String	ID of the voice asset associated with the virtual avatar.

**Table 33** ActionTagInfo
Parameter	Type	Description
action_name_zh	String	Atomic action name in Chinese.
action_name_en	String	Atomic action name in English.
action_duration	Float	Action duration. Value range: 0~100
catalog	String	Action category name.
file_name	String	Sample video file name. The value contains 1 to 256 characters.
tag	String	Action tag.

**Table 34** ImageAssetMeta
Parameter	Type	Description
codec	String	Details: Image encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
width	Integer	Details: Image width. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
height	Integer	Details: Image height. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
size	Long	Details: Image size. Constraints: Automatically extracted. Default value: N/A Value range: 0~9223372036854775807
mode	String	Details: Image form. Constraints: Automatically extracted. Options: Horizontal: horizontal Vertical: vertical Default value: N/A
frame_rate	String	Definition Video frame rate. Constraints Automatically extracted. Range The value contains 0 to 32 characters. Default Value N/A
duration	Integer	Definition Duration, in seconds. Constraints Automatically extracted. Default Value N/A Value range: 0~86400
error_info	ErrorResponse object	Error message

**Table 35** VideoAssetMeta
Parameter	Type	Description
video_codec	String	Details: Video encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
width	Integer	Details: Video image width. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
height	Integer	Details: Video height. Constraints: Automatically extracted. Default value: N/A Value range: 0~8196
frame_rate	String	Details: Video frame rate. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
video_bit_rate	Integer	Details: Average video bitrate, in kbit/s. Constraints: Automatically extracted. Default value: N/A Value range: 0~104857600
duration	Integer	Details: Duration, in second. Constraints: Automatically extracted. Default value: N/A Value range: 0~86400
audio_codec	String	Details: Audio encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
audio_bit_rate	Integer	Details: Average audio bitrate, in kbit/s. Constraints: Automatically extracted. Default value: N/A Value range: 0~16384
audio_channels	Integer	Details: Number of audio channels. Constraints: Automatically extracted. Default value: N/A Value range: 0~100
sample	Integer	Details: Sampling rate, in Hz. Constraints: Automatically extracted. Default value: N/A Value range: 0~100000
mode	String	Details: Horizontal or vertical display. Constraints: Automatically extracted. Options: Horizontal: horizontal Vertical: vertical Default value: N/A
video_transcoding_status	String	Details: Video transcoding status. Constraints: Automatically filled. Options: WAITING: waiting for transcoding TRANSCODING: transcoding... FAILED: failed SUCCEEDED: succeeded Default value: N/A
error_info	ErrorResponse object	Error message

**Table 36** AudioAssetMeta
Parameter	Type	Description
duration	Integer	Details: Duration, in second. Constraints: Automatically extracted. Default value: N/A Value range: 0~86400
audio_codec	String	Details: Audio encoding format. Constraints: Automatically extracted. Options: The value contains 0 to 32 characters. Default value: N/A
audio_bit_rate	Integer	Details: Average audio bitrate, in kbit/s. Constraints: Automatically extracted. Default value: N/A Value range: 0~16384
audio_channels	Integer	Details: Number of audio channels. Constraints: Automatically extracted. Default value: N/A Value range: 0~100
sample	Integer	Details: Sampling rate, in Hz. Constraints: Automatically extracted. Default value: N/A Value range: 0~100000
error_info	ErrorResponse object	Error message

**Table 37** ErrorResponse
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

**Table 38** SystemProperty
Parameter	Type	Description
action	String	Details: Operation. Constraints: System properties cannot be modified by common users. Options: ADD: adding DELETE: deleting Default value: N/A
key	String	Definition System properties. Constraints System properties cannot be modified by common users. Range Public asset property: BACKGROUND_IMG: 2D background image for video production. Set value to Yes. CREATED_BY_PLATFORM: whether it is generated by the platform BACKGROUND_SCENE: 2D background scene for video production. Set value to Horizontal or Vertical. MEITUAN_MATERIAL_APPROVED: whether the asset is approved by Meituan. Set value to YES. IS_CONTROLLED: whether the asset is controlled. This parameter is used only for image and voice assets. The value can be Yes. LIVE_IS_AUTHORIZED: whether livestreaming is authorized. This parameter is used only for image and voice assets. The value can be Yes. VIDEO_IS_AUTHORIZED: whether the video production service is authorized. This parameter is used only for image and voice assets. The value can be Yes. CHAT_IS_AUTHORIZED: whether the intelligent interaction service is authorized. This parameter is used only for image and voice assets. The value can be Yes. Virtual avatar asset property: MATERIAL_IMG: image, which is used as an overlay Set value to Yes. Otherwise, the image cannot be displayed in the image overlay area on the video production and livestreaming pages of the console. MATERIAL_VIDEO: video, which is used as an overlay Set value to Yes. Otherwise, the video cannot be displayed in the video overlay area on the video production and livestreaming pages of the console. DIGITAL_HUMAN_2D_VIDEO: virtual avatar video BUSINESS_CARD_VIDEO: business card video BUSSINESS_CARD_VIDEO: business card video (expired) PHOTO_VIDEO: photo-based virtual avatar video Default Value N/A
value	String	Details: System attribute value. Constraints: System properties cannot be modified by common users. Options: The value contains 1 to 1,024 characters. Default value: N/A

**Table 39** AssetFileInfo
Parameter	Type	Description
file_id	String	File ID.
file_name	String	The file name is case-insensitive and can contain 1 to 256 characters.
file_md5	String	MD5 value of the file content. The value must contain 24 characters.
file_size	Long	Total file size. The value ranges from 1 to 5368709120. Value range: 1~5368709120
file_type	String	File type (the file name extension is extracted by default).
asset_file_category	String	File category in an asset. Each asset type contains different file categories. MAIN: main file COVER: thumbnail file PAGE: content page image SAMPLE: sample audio OTHER: other files TEMPORARY: temporary folder (used to upload new files during file replacement) PACKAGE: packaged asset file NOTE: When the asset type is PPT, categories are MAIN, COVER, PAGE, and OTHER. When the asset type is VOICE_MODEL, categories are MAIN, SAMPLE (sample audio file), and OTHER. When the asset type is HUMAN_MODEL_2D, categories are MAIN, COVER, SAMPLE (sample action), and OTHER (mask file). When the asset type is BUSINESS_CARD_TEMPLET, categories are MAIN and COVER (business card demo).
download_url	String	File download URL, which is valid for 24 hours.
state	String	File status. Options: CREATING: being uploaded CREATED: uploaded (auto approved) FAILED: upload failed CANCELLED: upload cancelled DELETING: being deleted DELETED: deleted UPLOADED: uploaded (not approved yet) REVIEW: manual review (uploaded) BLOCK: frozen
block_reason_code	String	Reason number for freezing.
reason	String	Rejection reason.
file_extra_meta	FileExtraMeta object	File data.

**Table 40** FileExtraMeta
Parameter	Type	Description
video_transcoding_status	String	Video transcoding status. WAITING: waiting TRANSCODING: transcoding FAILED: failed SUCCEEDED: succeeded

**Table 41** AutoOperationConfig
Parameter	Type	Description
operation	String	BLOCK: frozen DELETE: deleting
operation_time	String	Resource expiration time. The format complies with RFC 3339, for example, 2025-01-10T00:00:00Z.

Status code: 400

**Table 42** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Example Requests

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

{
  "asset_name" : "Sara Model",
  "asset_description" : "Virtual employee",
  "asset_type" : "HUMAN_MODEL_2D",
  "tags" : [ "Virtual employee" ]
}

Example Responses

Status code: 200

Successful.

{
  "asset_id" : "93769b5a-c8c6-4692-9c95-53933a1f0c93",
  "asset_name" : "Male Teacher",
  "asset_description" : "Male teacher model.",
  "create_time" : "2021-10-30T12:30:35Z",
  "asset_type" : "HUMAN_MODEL_2D",
  "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"
  } ]
}

Status code: 400

Parameters error, including the error code and its description.

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

Status Codes

Status Code	Description
200	Successful.
400	Parameters error, including the error code and its description.

Error Codes

See Error Codes.

Parent Topic: Digital Asset Management

Previous topic: Querying Assets

Next topic: Deleting an Asset

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot