华为云用户手册

概述 数字内容生产线服务（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。 说明： *不允许输入中文。

响应示例 状态码： 200 处理成功返回。 { "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66", "state" : "SUC CES S", "error_info" : null, "create_time" : "2022-11-30T06:59:56Z" } 状态码： 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_id String 任务ID。 state String 任务的状态。 WAITING：等待 PROCESSING：处理中 SUCCEED：成功 FAILED：失败 CANCELED：取消 error_info ErrorResponse object 错误信息。 create_time String 任务创建时间。 表5 ErrorResponse 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": "********", //IAM用户密码 "domain": { "name": "domainname" //IAM用户所属账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

响应参数 状态码： 200 表32 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表33 响应Body参数 参数 参数类型 描述 room_id String 直播间ID 状态码： 400 表34 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表35 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表36 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 成功。 { "room_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 { "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" : "大家好，我是云笙" } } ] } ], "live_event_callback_config" : { "live_event_type_callback_url" : "https://xxx/xxx/xxx?xxx=xxx", "auth_type" : "NONE", "callback_event_type" : [ "SHOOT_SCRIPT_SWITCH" ] } }

响应参数 状态码： 200 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表8 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码： 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 错误描述。

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

请求参数 表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参数 参数 是否必选 参数类型 描述 business_card_type 是 String 数字人名片类型。 2D_DIGITAL_HUMAN_CARD：分身数字人名片。 card_templet_asset_id 是 String 数字人名片模板资产ID。 card_text_config 是 BusinessCardTextConfig object 用户输入的数字人名片信息。实际可以填写哪些字段取决于名片模板。 card_image_config 是 BusinessCardImageConfig object 用户上传的用于制作数字人名片的图片。 introduction_type 否 String 自我介绍驱动方式。 TEXT: 文本驱动，即通过 TTS 合成语音。文本驱动需要填写introduction_text和voice_asset_id参数。 AUDIO: 语音驱动，需要在资产库中先上传语音资产。语音驱动需要填写introduction_audio_asset_id参数。 introduction_text 否 String 自我介绍文本，用于驱动数字人口型。 voice_asset_id 否 String 音色资产ID。 introduction_audio_asset_id 否 String 自我介绍语音资产ID，用于驱动数字人口型。 说明： 介绍语音需要作为asset_type=AUDIO资产先上传至资产库。 video_asset_name 否 String 输出名片视频资产名称。默认取card_name的值 gender 否 String 性别。 MALE：男性 FEMALE：女性 review_config 否 ReviewConfig object 内容审核配置 表4 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。可填写一些公司广告语等 表5 BusinessCardImageConfig 参数 是否必选 参数类型 描述 human_image 是 String 人物照片，需要Base64编码。 logo_image 否 String Logo图片，需要Base64编码。 表6 ReviewConfig 参数 是否必选 参数类型 描述 no_need_review 否 Boolean 免审核。 目前仅白名单用户可使用此参数，非白名单用户跟随系统策略审核。

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 model_asset_id String 数字人资产ID。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表9 响应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 FormData参数 参数 是否必选 参数类型 描述 file 是 File 照片文件。 说明： 只能上传jpg/jpeg/png格式文件， 最大分辨率为3840*2160 style_id 是 String 数字人风格ID。 system_male_001：男性风格01 system_female_001：女性风格01 system_male_002：男性风格02 system_female_002：女性风格02 name 是 String 数字人模型名称，首次创建时使用。 notify_url 否 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" }

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 状态码： 401 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表5 响应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-App-UserId 否 String 第三方用户ID。 说明： *不允许输入中文。

响应示例 状态码： 200 处理成功返回。 { "jobId" : "438f02b2e97d471e840bc4e6ec3ef50", "audio" : "yED1UPfw5LD94R3RMI...", "blendshapes" : [ "{\"timeStamp\":1.8,\"weights\":[0.145,0.002,0.002,0.047,0.014,0.023,0.257,0.106,0.084,0.017,0.015,0.018,0.022,0.051,0.032,0.0,0.256,0.379,0.367,0.075,0.082,0.134,0.138,0.028,0.133,0.002,0.038,0.0,0.0,0.02475,0.02475,0.03585,0.052,0.051,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0051,0.027,0.00435,0.0]}", "{\"timeStamp\":1.8166667,\"weights\":[0.137,0.002,0.002,0.049,0.014,0.023,0.235,0.101,0.079,0.018,0.016,0.017,0.021,0.048,0.032,0.0,0.222,0.377,0.366,0.069,0.076,0.163,0.165,0.028,0.128,0.002,0.038,0.0,0.0,0.02475,0.02475,0.0357,0.051,0.051,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.00495,0.027,0.00435,0.0]}" ], "animations" : [ { "animation_asset_id" : "bbb5d2e4004b01ac6024ed9388058a53", "timestamp" : 2.088 } ] } 状态码： 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码： 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }

请求参数 表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信息。

URI GET /v1/{project_id}/ttsa-jobs/{job_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 job_id 是 String 任务ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量，表示生成内容时间偏移，目前每次返回2秒内容。

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 jobId String 任务ID。 start_time String 驱动任务开始时间，格式遵循：RFC 3339， 例 “2020-07-30T10:43:17Z” end_time String 驱动任务结束时间，格式遵循：RFC 3339， 例 “2020-07-30T10:45:17Z” is_tail Boolean 是否为尾部(任务数据已全部生成，后续没有新的数据) audio String 音频数据，Base64编码，1秒内的数据。 blendshapes Array of strings 语音驱动的表情基数据。 animations Array of AnimationItem objects 手工指定的动作库动作数据。 motions Array of MotionItem objects 语义驱动的智能动作数据。 表6 AnimationItem 参数 参数类型 描述 animation_asset_id String 动作资产ID。 timestamp Float 时间戳，相对时间戳。 单位秒。 保留3位小数。 表7 MotionItem 参数 参数类型 描述 timestamp Float 时间戳，相对时间戳。 单位秒。 保留3位小数。 root Array of floats root 3维坐标。 joints Array of floats 75个关节点，四元数。 eyes Array of floats 眼动数据 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表4 响应Body参数 参数 参数类型 描述 job_id String 照片建模任务ID。 state String 任务的状态。 WAITING：等待任务调度 PROCESSING：正在处理 PARTIAL_SUCCEED：部分成功（模型生成，截图失败） SUCCEED：成功 FAILED：失败 CANCELED：取消 start_time String 任务开始时间，格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”。 end_time String 任务结束时间，格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”。 error_info ErrorResponse object 任务出错信息 model_asset_id String 模型资产ID。 name String 数字人模型名称。 style_id String 风格ID。 model_cover_url String 模型封面URL。 表5 ErrorResponse 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 成功。 { "job_id" : "f503894a-20e2-4274-ad88-8364f59a93da_ SMS ", "state" : "SUCCEED", "start_time" : "2022-11-07T11:43:08Z", "end_time" : "2022-11-07T11:43:32Z", "error_info" : null, "model_asset_id" : "3fcb602bdbe4982ff59832b172949a21", "name" : "my_model", "style_id" : "system_male_001", "model_cover_url" : "https://digitalhuman.obs.cn-east-3.myhuaweicloud.com:443/0d697589d98091f12f92c0073501cd79/3fcb602bdbe4982ff59832b172949a21/656dffa9f8fa60cfc99701d4034fd8a4.png?AccessKeyId=XCQKTA8IWQPCAUQS4SDA&Expires=1668752064&Signature=DXJ9rIuf0Sf4aDlR95icBU%2Bu9Y8%3D" } 状态码： 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" }

请求参数 表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 表23 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表24 响应Body参数 参数 参数类型 描述 script_id String 剧本ID audio_files ShootScriptAudioFiles object 用于语音驱动的音频文件上传URL列表。 表25 ShootScriptAudioFiles 参数 参数类型 描述 audio_file_url Array of ShootScriptAudioFileItem objects 用于语音驱动的音频文件上传URL。 表26 ShootScriptAudioFileItem 参数 参数类型 描述 sequence_no Integer 剧本序号。 audio_file_upload_url String 语音驱动音频文件上传URL。创建和更新脚本时返回。单个文件最大100M。支持上传MP3/WAV/M4A文件。 audio_file_download_url String 语音驱动音频文件下载URL。查询脚本详情时返回。 状态码： 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 错误描述。