华为云用户手册

响应参数 状态码： 200 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表8 响应Body参数 参数 参数类型 描述 live_event_report_url String 刷新后的直播事件上传URL 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI POST /v1/{project_id}/smart-live-rooms/{room_id}/smart-live-jobs/{job_id}/live-event-report 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 room_id 是 String 剧本ID。 job_id 是 String 任务ID。 表2 Query参数 参数 是否必选 参数类型 描述 auth_key 否 String 鉴权Key。通过HmacSHA256生成的鉴权key expires_time 否 Long 鉴权key过期时间。从1970年1月1日（UTC/GMT的午夜）开始所经过的豪秒数。 refresh_url 否 Boolean 是否刷新URL

请求参数 表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。 说明： *不允许输入中文。 表4 请求Body参数 参数 是否必选 参数类型 描述 total 是 Integer 事件条目数。 events 否 Array of LiveEvent objects 事件内容。 review_config 否 ReviewConfig object 内容审核配置 表5 LiveEvent 参数 是否必选 参数类型 描述 timestamp 是 Long 事件戳。从1970-01-01 00:00:00:000开始的毫秒数 type 否 Integer 事件类型。 content 否 String 事件内容。 表6 ReviewConfig 参数 是否必选 参数类型 描述 no_need_review 否 Boolean 免审核。 目前仅白名单用户可使用此参数，非白名单用户跟随系统策略审核。

响应示例 状态码： 200 查询数字人风格列表请求成功 { "count" : 1, "styles" : [ { "style_id" : "24bad716-87b1-45e5-8912-6102f7693265", "name" : "国风", "description" : "国风风格", "tags" : [ "华为" ], "create_time" : "2021-09-30T10:43:17Z", "update_time" : "2021-10-30T12:30:35Z", "state" : "CREATING", "style_assets" : [ { "asset_type" : "MATERIAL", "asset_id" : "93769b5a-c8c6-4692-9c95-53933a1f0c93" } ], "extra_meta" : { "picture_modeling_enable" : true, "edit_enable" : true, "edit_engine" : "Blender" } } ] } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID 表5 响应Body参数 参数 参数类型 描述 count Integer 风格信息总数 styles Array of StyleInfo objects 风格信息列表 表6 StyleInfo 参数 参数类型 描述 name String 数字人风格化名称 description String 数字人风格化描述 project_id String 租户ID status String 状态 sex String 性别 tags Array of strings 标签。单个标签16字节，多个用逗号分隔，最多50个。 style_assets Array of StyleAssetItem objects 风格化素材资产组合。 extra_meta StyleExtraMeta object 数字人风格额外元数据信息 style_id String 数字人风格ID create_time String 数字人风格创建时间，格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”。 update_time String 数字人风格更新时间，格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”。 state String 数字人风格状态枚举 CREATING：创建中 PUBLISHED：已发布 DELETED：已删除 UNPUBLISHED：未发布 PUBLISHING：发布中 表7 StyleAssetItem 参数 参数类型 描述 asset_id String 资产ID asset_type String 资产类型 ANIMATION：动作 MATERIAL：素材 cover_url String 封面图URL 表8 StyleExtraMeta 参数 参数类型 描述 picture_modeling_enable Boolean 是否支持照片建模 edit_enable Boolean 是否支持模型编辑 edit_engine String 编辑使用引擎 model_id String 照片建模算法调用的模型类型 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表10 响应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。 说明： *不允许输入中文。

请求示例 /v1/test-project-id/smart-live-rooms-scripts/language-check { "target_language" : "zh-cn", "shoot_scripts" : [ { "sequence_no" : 0, "title" : "test-title", "text_config" : { "text" : "你好，我是华为云云宝" } } ] }

响应参数 状态码： 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。 说明： *不允许输入中文。

响应示例 状态码： 200 成功。 { "command" : "GET_CURRENT_PLAYING_SCRIPTS", "result" : "" } 状态码： 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 表5 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表6 响应Body参数 参数 参数类型 描述 command String 命令名称。 INSERT_PLAY_SCRIPT: 插入表演脚本。用于互动回复。数字人不变，背景不变。params结构定义：ShootScript REWRITE_PLAY_SCRIPT: 动态编辑未播放剧本。params结构定义：scence_scripts INSERT_PLAY_AUDIO: 插入驱动音频。用于音频直接驱动。数字人不变，背景不变。params结构定义：PlayAudioInfo GET_CURRENT_PLAYING_SCRIPTS: 查询本轮剧本列表。响应为LivePlayingScriptList结构 result String 命令执行结果 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求示例 POST https://metastudio.cn-east-3.myhuaweicloud.com/v1/70b76xxxxxx34253880af501cdxxxxxx/smart-live-rooms/24bad716-87b1-45e5-8912-6102f7693265/smart-live-jobs/26f06524-4f75-4b3a-a853-b649a21aaf66/command { "command" : "INSERT_PLAY_SCRIPT", "params" : { "text" : { "text_config" : { "text" : "看到评论区有观众问问题，我来响应下。" }, "play_type" : "APPEND", "rule_index" : "test-rule-index" } } }

请求参数 表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参数 参数 是否必选 参数类型 描述 command 是 String 命令名称。 INSERT_PLAY_SCRIPT: 插入表演脚本。用于互动回复。数字人不变，背景不变。params结构定义：PlayTextInfo REWRITE_PLAY_SCRIPT: 动态编辑未播放剧本。params结构定义：scence_scripts INSERT_PLAY_AUDIO:插入驱动音频。用于音频直接驱动。数字人不变，背景不变。params结构定义：PlayAudioInfo GET_CURRENT_PLAYING_SCRIPTS: 查询本轮剧本列表。响应为LivePlayingScriptList结构 SHOW_LAYER：显示导播素材，用于直播导播。params结构定义：LiveGuideRuleInfo params 否 Object 命令参数。 review_config 否 ReviewConfig object 内容审核配置 表4 ReviewConfig 参数 是否必选 参数类型 描述 no_need_review 否 Boolean 免审核。 目前仅白名单用户可使用此参数，非白名单用户跟随系统策略审核。

响应示例 状态码： 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" }

请求参数 表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: 等待 PROCESSING: 处理中 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。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 回调的直播事件类型列表 表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" : "大家好，我是云笙" } } ] } ] }