华为云用户手册

请求参数 表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-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表4 响应Body参数 参数 参数类型 描述 job_info DigitalHumanBusinessCardJobInfo object 数字人名片制作任务信息。 card_templet_asset_id String 数字人名片模板资产ID。 card_text_config BusinessCardTextConfig object 用户输入的数字人名片信息。实际可以填写哪些字段取决于名片模板。 card_image_url BusinessCardImageUrl object 用于制作数字人名片的图片下载URL。 introduction_type String 自我介绍驱动方式。 TEXT: 文本驱动，即通过 TTS 合成语音 AUDIO: 语音驱动，需要在资产库中先上传语音资产 introduction_text String 自我介绍文本，用于驱动数字人口型。 voice_asset_id String 音色资产ID。 introduction_audio_asset_id String 自我介绍语音资产ID，用于驱动数字人口型。 说明： 介绍语音需要作为asset_type=AUDIO资产先上传至资产库。 gender String 性别。 MALE：男性 FEMALE：女性 表5 DigitalHumanBusinessCardJobInfo 参数 参数类型 描述 job_id String 任务ID。 state String 任务的状态。 WAITING: 等待 PRO CES SING: 处理中 SUCCEED: 成功 FAILED: 失败 CANCELED: 取消 start_time String 数字人名片制作开始时间。 end_time String 数字人名片制作结束时间。 output_asset_config OutputAssetInfo object 输出资产信息配置。 error_info ErrorResponse object 错误信息。 create_time String 任务创建时间。 lastupdate_time String 任务更新时间。 business_card_type String 数字人名片类型。 2D_DIGITAL_HUMAN_CARD：分身数字人名片 表6 OutputAssetInfo 参数 参数类型 描述 asset_id String 输出视频资产ID。 asset_name String 输出视频资产名称。 cover_url String 视频封面URL。 preview_video_url String 预览视频下载URL。URL有效期24小时。 说明： 分数数字人视频制作不支持预览。 表7 ErrorResponse 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 表8 BusinessCardTextConfig 参数 参数类型 描述 name String 姓名。 company String 企业或组织名称。 title String 职位名称。 mobile_phone String 手机号码。 phone String 固话号码。 mail String 电子邮件地址。 address String 地址。 other1 String 其他信息1。可填写一些公司广告语等 other2 String 其他信息2。可填写一些公司广告语等 other3 String 其他信息3。可填写一些公司广告语等 表9 BusinessCardImageUrl 参数 参数类型 描述 human_image_url String 任务照片下载URL。 logo_image String Logo图片下载URL。 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 404 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，MetaStudio的终端节点如表1所示。您也可以从地区和终端节点中查询服务的终端节点。 表1 MetaStudio的终端节点 区域名称 区域 终端节点（Endpoint） 华东-上海一 cn-east-3 metastudio.cn-east-3.myhuaweicloud.com 华北-北京四 cn-north-4 metastudio.cn-north-4.myhuaweicloud.com 父主题： 使用前必读

响应示例 状态码： 202 成功。 { "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66" } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

请求示例 POST https://metastudio.cn-north-4.myhuaweicloud.com/v1/70b76xxxxxx34253880af501cdxxxxxx/smart-live-rooms/24bad716-87b1-45e5-8912-6102f7693265/smart-live-jobs { "output_urls" : [ "rtmp://vfxpush.hwcloudvr.cn/live/lysa" ] }

响应参数 状态码： 202 表8 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表9 响应Body参数 参数 参数类型 描述 job_id String 直播任务ID。 rtc_room_info RTCRoomInfoList object RTC房间信息。 live_event_report_url String 直播事件上报地址。用户将自行获取的直播间事件上报到此地址，用于触发智能互动，自动回复话术。 live_event_callback_config LiveEventCallBackConfig object 直播事件回调通知配置 live_warning_info Array of LiveWarningItem objects 开播风险告警列表。 表10 RTCRoomInfoList 参数 参数类型 描述 app_id String RTC应用ID。 room_id String RTC房间ID。 users Array of RTCUserInfo objects 加入RTC房间用户信息。 表11 RTCUserInfo 参数 参数类型 描述 user_type String 用户类型。 CAPTURE: 直播助手，将摄像头获取视频流推送到RTC房间 ANIMATION: VDS服务，从RTC房间拉视频流生成动作数据 RENDER: 渲染服务，将动作数据渲染成数字人动画 PLAYER: 普通观看方，可选择原始视频流或者数字人动画视频流观看 INFERENCE_USER: 数字人推理端用户。从RTC房间接收音频流，并推送视频流到RTC房间 END_USER: 端侧用户。从推送音频流到RTC房间，并从RTC房间接收视频流 user_id String RTC用户ID。 signature String RTC鉴权token。 ctime Long 有效期。时间戳，单位：秒。 表12 LiveEventCallBackConfig 参数 参数类型 描述 live_event_type_callback_url String 直播事件回调地址。https地址，需自带鉴权串。 auth_type String 认证类型。 NONE。URL中自带认证。 MSS_A。HMA CS HA256签名模式，在URL中追加参数:hwSecret,hwTime。取值方式：hwSecret=hmac_sha256(Key, URI（live_event_callback_url）+ hwTime)&hwTime=hex(timestamp) key String 密钥Key callback_event_type Array of strings 回调的直播事件类型列表 表13 LiveWarningItem 参数 参数类型 描述 warning_type String 告警类型。 TOO_LESSS_SCRIPT_ITEMS：段落（话术）数量太少。 TOO_SHORT_SCRIPT_TIME：段落（话术）总时长太短。 TOO_LESS_DANMAKU_RULES： 弹幕互动规则太少。 RANDOM_PLAY_CLOSED: 随机播放开关关闭。 ROTATION_MODEL_CLOSED: 主播轮转未配置。 状态码： 400 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表15 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表16 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表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-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。 表3 请求Body参数 参数 是否必选 参数类型 描述 video_config 否 VideoConfig object 视频输出配置。 play_policy 否 PlayPolicy object 剧本播放策略 output_urls 否 Array of strings RTMP视频推流第三方直播平台地址。 stream_keys 否 Array of strings RTMP视频推流第三方直播平台流秘钥，与推流地址对应。 interaction_callback_url 否 String 互动回调URL，含鉴权信息。 live_event_callback_config 否 LiveEventCallBackConfig object 直播事件回调通知配置 表4 VideoConfig 参数 是否必选 参数类型 描述 clip_mode 否 String 输出视频的剪辑方式。默认值RESIZE。 RESIZE：视频缩放。 CROP：视频裁剪。 codec 是 String 视频编码格式及视频文件格式。 H264: h264编码，输出mp4文件 VP8：vp8编码，输出webm文件 bitrate 是 Integer 输出平均码率。 单位：kbps。 最小值40，最大值30000。 说明： 分身数字人视频制作采用质量优先，可能会超过设置的码率。 分身数字人直播码率范围[1000, 8000]。 width 是 Integer 视频宽度。 单位：像素。 最小值320，最大值2560。 说明： clip_mode=RESIZE时，当前支持1920x1080、1080x1920、1280x720、720x1280、3840x2160、2160x3840六种分辨率。4K分辨率视频需要分身数字人模型支持4K的情况下才能使用。 clip_mode=CROP，裁剪后视频，（dx,dy）为原点，保留视频像宽度为width。 分身数字人直播目前只支持1080x1920。 height 是 Integer 视频高度。 单位：像素。 最小值320，最大值2560。 说明： clip_mode=RESIZE时，当前支持1920x1080、1080x1920、1280x720、720x1280、3840x2160、2160x3840六种分辨率分辨率。 clip_mode=CROP，裁剪后视频，（dx,dy）为原点，保留视频像高度为height。 分身数字人直播目前只支持1080x1920。 frame_rate 否 String 帧率。 单位：FPS。 说明： 分身数字人视频固定25FPS。 is_subtitle_enable 否 Boolean 输出的视频是否带字幕。默认false。 说明： true: 打开字幕 false: 关闭字幕 subtitle_config 否 SubtitleConfig object 字幕配置。 dx 否 Integer 裁剪视频左上角像素点坐标。 clip_mode= CROP时生效。 说明： *横屏（16:9）视频像素为1920x1080；竖屏（9:16）视频像素为1080x1920。 dy 否 Integer 裁剪视频左上角像素点坐标。 clip_mode= CROP时生效。 说明： *横屏（16:9）视频像素为1920x1080；竖屏（9:16）视频像素为1080x1920。 表5 SubtitleConfig 参数 是否必选 参数类型 描述 dx 否 Integer 字幕左上角像素点坐标。 说明： *横屏（16:9）视频像素为1920x1080；竖屏（9:16）视频像素为1080x1920。 dy 否 Integer 字幕左上角像素点坐标。 说明： *横屏（16:9）视频像素为1920x1080；竖屏（9:16）视频像素为1080x1920。 font_name 否 String 字体。当前支持的字体： HarmonyOS_Sans_SC_Black：鸿蒙粗体 HarmonyOS_Sans_SC_Regular：鸿蒙常规 HarmonyOS_Sans_SC_Thin：鸿蒙细体 font_size 否 Integer 字体大小。 取值范围：[4, 120] h 否 Integer 字幕框高度 w 否 Integer 字幕框宽度 表6 PlayPolicy 参数 是否必选 参数类型 描述 repeat_count 否 Integer 剧本重复播放次数。 -1表示持续重复，直至人工停止 0 表示不重复，仅执行一次 其他值n，实际运行次数为n+1次 auto_play_script 否 Boolean 是否自动播放剧本。 true: 服务完成任务初始化后，自动播放剧本 false: 服务完成任务初始化后，等待信号后再开始播放剧本 play_mode 否 String 驱动方式。默认TEXT TEXT: 文本驱动，即通过TTS合成语音 AUDIO: 语音驱动 random_play_mode 否 String 随机播报模式。 NONE: 不启动随机播报。 SCENE: 按场景随机播报。场景内段落按顺序播报。 SCRIPT_ITEM：按段落随机播报。场景按顺序播报。 SCENE_AND_SCRIPT_ITEM： 场景和段落都随机播报。 表7 LiveEventCallBackConfig 参数 是否必选 参数类型 描述 live_event_type_callback_url 否 String 直播事件回调地址。https地址，需自带鉴权串。 auth_type 否 String 认证类型。 NONE。URL中自带认证。 MSS_A。HMACSHA256签名模式，在URL中追加参数:hwSecret,hwTime。取值方式：hwSecret=hmac_sha256(Key, URI（live_event_callback_url）+ hwTime)&hwTime=hex(timestamp) key 否 String 密钥Key callback_event_type 否 Array of strings 回调的直播事件类型列表

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 count Integer 视频制作任务总数。 jobs Array of DigitalHumanVideo objects 视频制作任务列表。 表6 DigitalHumanVideo 参数 参数类型 描述 job_id String 任务ID。 state String 任务的状态。 WAITING：等待 PROCESSING：处理中 SUCCEED：成功 FAILED：失败 CANCELED：取消 start_time String 数字人视频制作开始时间。 end_time String 数字人视频制作结束时间。 duration Float 数字人视频内容时长。 output_asset_config OutputAssetInfo object 输出资产信息。 error_info ErrorResponse object 错误信息。 create_time String 任务创建时间。 lastupdate_time String 任务更新时间。 表7 OutputAssetInfo 参数 参数类型 描述 asset_id String 输出视频资产ID。 asset_name String 输出视频资产名称。 cover_url String 视频封面URL。 preview_video_url String 预览视频下载URL。URL有效期24小时。 说明： 分数数字人视频制作不支持预览。 表8 ErrorResponse 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 404 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表3 请求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-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。

响应示例 状态码： 200 处理成功返回。 { "count" : 1, "jobs" : [ { "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66", "state" : "SUCCEED", "start_time" : "2022-01-18T16:29:36Z", "end_time" : "2022-01-18T16:30:36Z", "duration" : 60, "output_asset_config" : { "asset_id" : "942e65a5fd219a2e01fb08d881cfadb9", "asset_name" : "One Day", "cover_url" : "https://digitalhuman.obs.cn-east-3.myhuaweicloud.com:443/0d697589d98091f12f92c0073501cd79/942e65a5fd219a2e01fb08d881cfadb9/20d367508e62d3d4ad608cedbe81bd35.png?AccessKeyId=XCQKTA8IWQPCAUQS4SDA&Expires=1671241457&Signature=zVGMVbI5ji9rr8epD1Cir5OGIRk%3D" }, "error_info" : null, "create_time" : "2022-11-30T06:59:56Z", "lastupdate_time" : "2022-11-30T07:00:09Z" } ] } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 404 { "error_code" : "MSS.00000002", "error_msg" : "Not Found" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

响应示例 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

请求参数 表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-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

请求示例 PUT https://metastudio.cn-north-4.myhuaweicloud.com/v1/70b76xxxxxx34253880af501cdxxxxxx/smart-live-rooms/24bad716-87b1-45e5-8912-6102f7693265 { "room_name" : "大自然的传说", "room_description" : "课件", "scene_scripts" : [ { "script_name" : "大自然的传说 一", "model_asset_id" : "a5d295cdb345c11bd9f36bc22ced3a7a", "voice_config" : { "voice_asset_id" : "a5d295cdb345c11bd9f36bc22ced3a7a" }, "background_config" : [ { "background_type" : "IMAGE", "background_config" : "978f893e1de4553c183b7a805e6290f5" } ], "shoot_scripts" : [ { "sequence_no" : 1, "text_config" : { "text" : "大家好，我是云笙" } } ] } ] }

响应参数 状态码： 200 表25 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表26 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码： 400 表27 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表28 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表29 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求示例 POST https://metastudio.cn-north-4.myhuaweicloud.com/v1/0d697589d98091f12f92c0073501cd79/2d-digital-human-videos { "model_asset_id" : "0c7798664ee7178b3dba3bbef57c32e7", "voice_config" : { "voice_asset_id" : "394f3a27cd0b3d6164ca75c3db1edf6c", "speed" : 100, "pitch" : 100, "volume" : 140 }, "video_config" : { "codec" : "H264", "bitrate" : 5000, "width" : 1920, "height" : 1080, "frame_rate" : "30" }, "shoot_scripts" : [ { "sequence_no" : 0, "shoot_script" : { "text_config" : { "text" : "大家好，我是云玲。" }, "background_config" : [ { "background_type" : "IMAGE", "background_config" : "https://metastudio-sh1.obs.cn-east-3.myhuaweicloud.com:443/0d697589d98091f12f92c0073501cd79/c7885ffdfb347337a890208ca7fd07e3/34534f0262813a6838bdcfb8bc949af6.jpg?AccessKeyId=WTEZCVDFUF3XHXCTPIJ8&Expires=1686872878&Signature=zXGOEQlrgZ4yAUziwlGcdbXLPIM%3D", "human_position_2d" : { "position" : "MIDDLE" } } ] } } ], "output_asset_config" : { "asset_name" : "云玲自我介绍" } }

响应示例 状态码： 200 处理成功返回。 { "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66" } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

功能介绍 该接口用于删除分身数字人模型训练任务。同时需要删除训练任务相关的训练视频、身份证照片、授权文件、模型资产等。 该接口应当在任务处于以下状态时调用：WAIT_FILE_UPLOAD、AUTO_VERIFY_FAILED、MANUAL_VERIFYING、MANUAL_VERIFY_FAILED、TRAINING_DATA_PREPROCESS_FAILED、TRAIN_FAILED、INFERENCE_DATA_PREPROCESS_FAILED、JOB_SUCCESS、WAIT_USER_CONFIRM、JOB_REJECT、JOB_FINISH

请求参数 表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-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

请求参数 表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-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。

概述 数字内容生产线服务（MetaStudio），提供数字人的生成、视觉驱动、语音驱动、实时渲染等能力，快速为行业提供虚拟视频制作、主播推流等虚拟视频服务，适用于教育课件、电商带货、社交文娱等场景。 您可以使用本文档提供的API对华为云MetaStudio服务进行相关操作，如数字人照片建模等。支持的全部操作请参见API概览。 在调用华为云MetaStudio服务的API之前，请确保已经充分了解华为云MetaStudio服务的相关概念，详细信息请参见产品介绍。 父主题： 使用前必读

请求参数 表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 成功。 { "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://vr-dac-gamma.obs.cn-north-6.myhuaweicloud.com: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://vr-dac-gamma.obs.cn-north-6.myhuaweicloud.com: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 成功。 { "count" : 1, "interaction_rule_groups" : [ { "group_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66", "group_name" : "欢迎用户进入", "create_time" : "2022-11-30T06:59:55Z", "update_time" : "2022-12-05T12:30:37Z" } ] } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 count Integer 互动规则总数。 interaction_rule_groups Array of InteractionRuleGroupDetail objects 互动规则库列表。 表6 InteractionRuleGroupDetail 参数 参数类型 描述 group_id String 互动规则库ID group_name String 互动规则库名称 interaction_rules Array of InteractionRuleDetailInfo objects 互动规则列表 create_time String 创建时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 update_time String 更新时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 表7 InteractionRuleDetailInfo 参数 参数类型 描述 rule_index String 规则索引 rule_name String 规则名称 enabled Boolean 是否启用 event_type Integer 事件类型。 * 1：弹幕事件 * 2：用户入场事件 * 3：用户点赞事件 * 4：用户送礼事件 * 10: 预置话术事件 hit_condition HitCondition object 命中条件 trigger TriggerProcess object 触发器 review_config ReviewConfig object 内容审核 配置 rule_id String 互动规则ID create_time String 创建时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 update_time String 更新时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 表8 HitCondition 参数 参数类型 描述 relation String 条件关系；取值And或者Or priority Integer 优先级，数值越低优先级越高；取值0-999，默认值为500，为可选值 tags Array of HitConditionTag objects 匹配关系配置 表9 HitConditionTag 参数 参数类型 描述 tag String 事件内容关键字段 operation String 字段处理 SUM: 累计 AVG：平均 COUNT: 计数 NONE: 无处理 match String 匹配类型 EQUAL: 完全相等 REGEX：正则匹配 MATH_GT：数值大于 MATH_GE： 数值大于等于 MATH_LT：数值小于 MATH_LE：数值小于等于 MATH_EQ：数值相等 value String 匹配值 表10 TriggerProcess 参数 参数类型 描述 time_window Integer 处理抑制时长。单位秒。 -1 表示整场直播 0 表示无抑制，每次都触发 reply_mode String 回复类型。 SYSTEM_REPLY：系统自动回复设置的话术。 CALLBACK：回调给其他服务，携带设置的话术。 SHOW_LAYER: 显示叠加图层，不影响话术。 layer_config SmartLayerConfig object 智能图层配置。 reply_texts Array of strings 回复话术集 reply_audios Array of ReplyAudioInfo objects 回复音频集。填写audio_url。 reply_order String 回复次序 RANDOM：随机 ORDER：顺序循环 表11 SmartLayerConfig 参数 参数类型 描述 layer_type String 图层类型。 IMAGE： 素材图片图层 VIDEO： 素材视频图层 position LayerPositionConfig object 图层位置配置。 size LayerSizeConfig object 图层大小配置。 image_config SmartImageLayerConfig object 素材图片图层配置。 video_config SmartVideoLayerConfig object 素材视频图层配置。 表12 LayerPositionConfig 参数 参数类型 描述 dx Integer 图层左上角像素点的X轴位置值（画布左上角坐标是0x0）。 说明： 横屏（16:9）画布像素为1920x1080；竖屏（9:16）画布像素为1080x1920。 dy Integer 图层图片左上角像素点的Y轴位置值（画布左上角坐标是0x0）。 说明： 横屏（16:9）画布像素为1920x1080；竖屏（9:16）画布像素为1080x1920。 layer_index Integer 图片/视频/人物图的层顺序。 说明： 图层顺序从1开始的整数，底层图层顺序是1，往上依次增加。 表13 LayerSizeConfig 参数 参数类型 描述 width Integer 图层图片宽度像素值（相对画布大小）。 说明： 横屏（16:9）画布像素为1920x1080；竖屏（9:16）画布像素为1080x1920。 height Integer 图层图片高度像素值（相对画布大小）。 说明： 横屏（16:9）画布像素为1920x1080；竖屏（9:16）画布像素为1080x1920。 表14 SmartImageLayerConfig 参数 参数类型 描述 image_url String 图片文件的URL。 display_duration Integer 图片显示时长。单位s 0表示一直显示。 表15 SmartVideoLayerConfig 参数 参数类型 描述 video_url String 视频文件的URL。 video_cover_url String 视频封面文件的URL。 display_duration Integer 视频显示时长。单位s 0：表示一直显示。 表16 ReplyAudioInfo 参数 参数类型 描述 audio_url String 音频URL audio_name String 音频名 表17 ReviewConfig 参数 参数类型 描述 no_need_review Boolean 免审核。 目前仅白名单用户可使用此参数，非白名单用户跟随系统策略审核。 状态码： 400 表18 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表19 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表20 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表3 请求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-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。