华为云用户手册

URI GET /v1/{project_id}/digital-assets 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页显示的条目数量。 offset 否 Integer 偏移量，表示从此偏移量开始查询。 name 否 String 按名称模糊查询。 tag 否 String 按标签模糊查询。 start_time 否 String 起始时间。格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 end_time 否 String 结束时间。格式遵循：RFC 3339 如"2021-01-10T10:43:17Z"。 asset_type 否 String 资产类型。多个类型使用英文逗号分割。 HUMAN_MODEL：数字人模型 VOICE_MODEL：音色模型（仅系统管理员可上传） SCENE：场景模型 ANIMATION：动作动画 VIDEO：视频文件 IMAGE：图片文件 PPT：幻灯片文件 MATERIAL：风格化素材 HUMAN_MODEL_2D: 2D数字人网络模型 BUSINESS_CARD_TEMPLET: 数字人名片模板 MUSIC: 音乐 AUDIO: 音频 sort_key 否 String 排序字段，目前只支持create_time。 sort_dir 否 String 排序方式。 asc：升序 desc：降序 默认asc升序。 asset_source 否 String 资产来源。 SYSTEM：系统资产 CUSTOMIZATION：租户资产 ALL：所有资产 默认查询租户资产。 asset_state 否 String 资产状态。多个资产状态使用英文逗号分割。 CREATING：资产创建中，主文件尚未上传 FAILED：主文件上传失败 UNACTIVED：主文件上传成功，资产未激活，资产不可用于其他业务（用户可更新状态） ACTIVED：主文件上传成功，资产激活，资产可用于其他业务（用户可更新状态） DELETING：资产删除中，资产不可用，资产可恢复 DELETED：资产文件已删除，资产不可用，资产不可恢复 BLOCK：资产被冻结，资产不可用，不可查看文件。 默认查询所有状态的资产。 style_id 否 String 基于风格化ID查询关联资产。 system_male_001：男性风格01 system_female_001：女性风格01 system_male_002：男性风格02 system_female_002：女性风格02 render_engine 否 String 可用引擎。 UE：UE引擎 MetaEngine：MetaEngine引擎 说明： 该字段当前只对MetaEngine白名单用户生效 sex 否 String 性别。多选使用英文逗号分隔。 language 否 String 语言。多选使用英文逗号分隔。 system_property 否 String 系统属性。 key和value间用":"分隔，多个key之间用","分隔。 如system_property=BACKGROUND_IMG:Yes,RENDER_ENGINE:MetaEngine。 不同Key对应Value取值如下： 公共资产属性： BACKGROUND_IMG：视频制作的2D背景图片，可取值Yes CREATED_BY_PLATFORM：是否平台生成，可取值Yes 分身数字人资产属性： MATERIAL_IMG：素材图片，用作前景。可取值Yes MATERIAL_VIDEO：素材视频，用作前景。可取值Yes TO_BE_TRANSLATED_VIDEO: 视频翻译的源视频。可取值Yes 3D数字人资产属性： STYLE_ID：风格Id RENDER_ENGINE：引擎类型，可取值UE或MetaEngine BACKGROUND_SCENE：视频制作的2D背景场景，可取值Horizontal（横屏）或者Vertical（竖屏） action_editable 否 Boolean 动作是否可编辑。仅在分身数字人模型查询时有效。

请求参数 表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-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。

响应示例 状态码： 200 成功。 { "count" : 2, "assets" : [ { "asset_id" : "24bad716-87b1-45e5-8912-6102f7693265", "asset_name" : "云笙模型", "asset_description" : "云笙模型", "create_time" : "2021-10-30T12:30:35Z", "asset_type" : "HUMAN_MODEL", "asset_state" : "CREATING", "files" : [ null ] }, { "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" : "Hu8/Fjd5+Ra1oo2MZsZjbg==", "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" }

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

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

请求示例 POST https://metastudio.cn-north-4.myhuaweicloud.com/v1/ttsa-jobs { "speed" : 100, "voice_asset_id" : "d05b8edc4b8d189973c1735207ee1505", "volume" : 100, "auto_motion" : false, "script_type" : "TEXT", "text" : "测试用朗读文本。", "pitch" : 100, "style_id" : "262228a233820e80d99c4a223615e9a5" }

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表8 响应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参数 参数 是否必选 参数类型 描述 human_image 是 String 人物照片，需要Base64编码。照片分辨率不超过1080P。

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

请求示例 POST https://metastudio.cn-north-4.myhuaweicloud.com/v1/0d697589d98091f12f92c0073501cd79/photo-detection { "human_image" : "/9j/4AAQSkZJRgABAQEAYABgAAD/4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD" }

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

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 count Integer 数字人名片制作任总数。 jobs Array of DigitalHumanBusinessCardJobInfo objects 数字人名片制作任务列表。 表6 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：分身数字人名片 表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, "smart_live_jobs" : [ { "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66", "state" : "WAITING", "start_time" : "2022-01-18T16:29:36Z", "end_time" : "2022-01-18T16:30:36Z", "duration" : 60 } ] } 状态码： 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 数字人直播任务总数。 smart_live_jobs Array of SmartLiveJob objects 数字人直播任务列表。 表6 SmartLiveJob 参数 参数类型 描述 job_id String 数字人直播任务ID。 state String 数字人直播任务的状态。 WAITING: 等待 PROCESSING: 处理中 SUCCEED: 成功 FAILED: 失败 BLOCKED: 封禁 duration Float 数字人直播时长，单位秒。 start_time String 数字人直播任务开始时间。格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 end_time String 数字人直播任务结束时间。格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 error_info ErrorResponse object 数字人直播任务出错信息。 create_time String 数字人直播任务创建时间。格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 lastupdate_time String 数字人直播任务最后更新时间。格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"。 rtc_room_info RTCRoomInfoList object RTC房间信息。 live_event_report_url String 直播事件上报地址。用户将自行获取的直播间事件上报到此地址，用于触发智能互动，自动回复话术。 live_event_callback_config LiveEventCallBackConfig object 直播事件回调通知配置 stream_duration Float 数字人直播推流时长，单位秒 block_reason String 封禁信息 表7 ErrorResponse 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 表8 RTCRoomInfoList 参数 参数类型 描述 app_id String RTC应用ID。 room_id String RTC房间ID。 users Array of RTCUserInfo objects 加入RTC房间用户信息。 表9 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 有效期。时间戳，单位：秒。 表10 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 回调的直播事件类型列表 状态码： 400 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表13 响应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 处理成功返回。 { "job_id" : "efc5300ecdba4ea48d1ff13a9d907bc0", "training_video_upload_url" : [ "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_trainingVideo?param1=XXX¶m2=YYY", "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_trainingVideo?param1=XXX¶m2=YYY" ], "cover_upload_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_cover?param1=XXX¶m2=YYY", "id_card_image1_upload_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage1_tmp?param1=XXX¶m2=YYY", "id_card_image2_upload_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage2_tmp?param1=XXX¶m2=YYY", "grant_file_upload_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_grantFile_tmp?param1=XXX¶m2=YYY" } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 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。 说明： *不允许输入中文。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 分身数字人模型名称。该名称会作为资产库中分身数字人模型资产名称。 contact 否 String 分身数字人训练任务创建者联系方式，如手机或邮箱等。 command_message 否 String 命令类型： UPDATE_VIDEO: 更新视频 UPLOAD_VIDEO：上传视频 video_multipart_count 否 Integer 训练视频上传分片数。 is_background_replacement 否 Boolean 分身数字人是否需要背景替换。需要背景替换的分身数字人训练视频需要绿幕拍摄。 batch_name 否 String 分身数字人训练任务的批次名称。 tags 否 Array of strings 分身数字人训练任务标签。

请求示例 https://aaa.com/rest/v1/***/digital-human-training-manage/user/jobs/efc5300ecdba4ea48d1ff13a9d907bc0 { "name" : "测试角色", "contact" : "1**********", "video_multipart_count" : 2, "is_background_replacement" : true }

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 training_video_upload_url Array of strings 分身数字人训练视频上传URL。该url在文件上传成功后失效，只能上传一次。注意：视频必须是1080p或者4K分辨率（横、竖屏皆可）的mp4格式，视频长度须大于等于3分钟且小于等于10分钟，否则审核会不通过。 cover_upload_url String 模型封面上传URL。该URL在文件上传成功后失效，只能上传一次。 id_card_image1_upload_url String 身份证正面照片上传URL。该URL在文件上传成功后失效，只能上传一次。注意：非NA用户必须上传，否则审核会不通过。 id_card_image2_upload_url String 身份证反面照片上传URL。该URL在文件上传成功后失效，只能上传一次。注意：非NA用户必须上传，否则审核会不通过。 grant_file_upload_url String 授权书上传URL。该URL在文件上传成功后失效，只能上传一次。注意：非NA用户必须上传，否则审核会不通过。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

响应示例 状态码： 200 成功。 { "motion_capture_mode" : "AUTO", "input_info" : { "rtc_room_info" : { "app_id" : "62b41e4cfa163e19fe3012f4afb0254f", "room_id" : "038812f256464620b14545ed4208fd18", "users" : [ { "user_type" : "CAPTURE", "user_id" : "038812f256464620b14545ed4208fd18_capture", "signature" : "25bd86bf1ee9f3bdbd22b5a3bd68040f6e2ad997347a5486ca5890400f6d02cd", "ctime" : 1667899906 }, { "user_type" : "ANIMATION", "user_id" : "038812f256464620b14545ed4208fd18_animation", "signature" : "f18be6172bec6aff1f75574160a0b7d58b6f82fb0b780598d113852b9d99552d", "ctime" : 1667899906 }, { "user_type" : "RENDER", "user_id" : "038812f256464620b14545ed4208fd18_render", "signature" : "34557340ab070f0883c598809d41481964cc7fa74ec07566f2867ecd645ba186", "ctime" : 1667899906 }, { "user_type" : "PLAYER", "user_id" : "038812f256464620b14545ed4208fd18_player", "signature" : "c32f43f8b319c2b4c9881b3928dedd0b9aae8fd2db305cbac92e4529f766f232", "ctime" : 166789990 } ] } }, "output_info" : { "face_addr" : "121.36.196.49:30002", "body_addr" : "121.36.196.49:30001", "session_id" : 918 }, "job_id" : "0a9aaff946cc49cd965ba533464a8db0", "state" : "PROCESSING" } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 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参数 参数 参数类型 描述 motion_capture_mode String 视频驱动模式。 HEAD：头部 HALF_BODY：半身 FULL_BODY：全身 AUTO：自动 input_info InputInfo object 输入信息。 output_info OutputInfo object 输出信息。 job_id String 视频驱动任务ID。 state String 任务的状态。 WAITING：等待中 PROCESSING：处理中 SUCCEED：成功 FAILED：失败 start_time String 任务开始时间，格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”。 end_time String 任务结束时间，格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”。 表5 InputInfo 参数 参数类型 描述 rtc_room_info RTCRoomInfoList object RTC Animation加入房间信息。 表6 RTCRoomInfoList 参数 参数类型 描述 app_id String RTC应用ID。 room_id String RTC房间ID。 users Array of RTCUserInfo objects 接入RTC的用户信息。 表7 RTCUserInfo 参数 参数类型 描述 user_type String 接入RTC的用户类型。 CAPTURE：直播助手，将摄像头获取视频流推送到RTC房间 ANIMATION：VDS服务，从RTC房间拉视频流生成动作数据 RENDER：渲染服务，将动作数据渲染成数字人动画 PLAYER：普通观看方，可选择原始视频流或者数字人动画视频流观看 user_id String RTC用户ID。 signature String RTC鉴权token。 ctime Long 有效期。时间戳。 单位：秒。 表8 OutputInfo 参数 参数类型 描述 face_addr String 面部表情输入地址。 body_addr String 身体动作输入地址。 audio_addr String 音频输入地址。 session_id Integer 会话ID。 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求示例 POST https://metastudio.cn-north-4.myhuaweicloud.com/v1/70b76xxxxxx34253880af501cdxxxxxx/smart-live-rooms/24bad716-87b1-45e5-8912-6102f7693265/smart-live-jobs/26f06524-4f75-4b3a-a853-b649a21aaf66/stop

响应示例 状态码： 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 错误描述。

响应示例 状态码： 200 创建任务请求已接受 { "job_id" : "6eb78b2f-6ba2-4b59-bb07-d2fc372f8d39", "model_asset_id" : "89026ecafff64514e3e4b225f228bc0d" } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码： 403 { "error_code" : "MSS.00000005", "error_msg" : "Forbidden" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

请求示例 POST https://metastudio.cn-east-3.myhuaweicloud.com/v1/f488337c31c8e4622f1590735b134c65/picture-modelings-by-url { "picture_url" : "https://picture-obs.obs.cn-north-4.myhuaweicloud.com/picture/1.jpg", "style_id" : "system_female_001", "name" : "my_model" }