# 创建分身数字人模型训练任务 - Create2dModelTrainingJob #### 功能介绍 该接口用于创建分身数字人模型训练任务。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-metastudio/metastudio_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-metastudio/metastudio_02_0071.html)。 #### URI POST /v1/{project_id}/digital-human-training-manage/user/jobs 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID，获取方法请参考[获取项目ID](https://support.huaweicloud.com/api-metastudio/metastudio_02_0006.html)。 | #### 请求参数 表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：上传视频 - CONFIRM_ACTION_VIDEO: 确认动作编排视频 - GET_ACTION_VIDEO_MULTIPART: 获取动作编排视频分片 **取值范围：** 0\~64 **默认取值：** UPLOAD_VIDEO | | video_multipart_count | 否 | Integer | 训练视频上传分片数（上传时对唯一训练视频文件的数据分片，用于对该文件的并发上传，不是分多个视频文件上传）。 **取值范围：** 1\~1000 **默认取值：** 1 | | action_video_multipart_count | 否 | Integer | 动作视频上传分片数。 **取值范围：** 1\~1000 **默认取值：** 1 | | is_background_replacement | 否 | Boolean | 分身数字人是否需要背景替换。需要背景替换的分身数字人训练视频需要绿幕拍摄。 **默认取值：** true | | batch_name | 否 | String | 分身数字人训练任务的批次名称。 | | tags | 否 | Array of strings | 分身数字人训练任务标签。 | | model_version | 否 | String | 分身数字人模型版本。默认是V3.2版本模型。 - V3.2：V3.2版本模型 - V3.3: 极速版flexus训练用的模型 说明： - V3和V2版本已废弃不用 **取值范围：** 0\~64 **默认取值：** V3.2 | | is_ondemand_resource | 否 | Boolean | 分身数字人训练任务类型 true 按需任务 false 普通任务 **默认取值：** false | | is_flexus | 否 | Boolean | 是否是基础版的形象训练 **默认取值：** false | | is_fast_flexus | 否 | Boolean | 是否极速版flexus **默认取值：** false | | is_live_copy | 否 | Boolean | 是否是直播间复刻任务 **默认取值：** false | | is_only_human_model | 否 | Boolean | 是否只训练形象模型，不训练声音模型。仅Flexus版本时有效，默认false。 **默认取值：** false | | audio_source_type | 否 | String | 声音来源类型 - VIDEO：视频中抽取音频 - AUDIO：单独上传的音频 **默认取值：** VIDEO | | voice_properties | 否 | [VoiceProperties] object | 声音配置信息，为Flexus版声音的配置项，标准版声音不支持此配置。 | | supported_service | 否 | Array of strings | 该任务所生成的模型支持的业务类型，可多选。 Flexus版数字人仅支持选择"VIDEO_2D"。 **默认取值：** \[VIDEO_2D,LIVE_2D\] | 表4VoiceProperties | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | job_tag | 是 | String | 任务标签，为Flexus版声音的配置。 - ECOMMERCE: 电商 - NEWS: 新闻 - MARKETING: 营销 | | sex | 是 | String | 语音性别，是男性声音还是女性声音，为Flexus版声音的配置。 - FEMALE: 女性 - MALE: 男性 **默认取值：** FEMALE | | language | 是 | String | 训练语言，当前仅支持中文，为Flexus版声音的配置。 - CN: 中文 - EN: 英文 | #### 响应参数 **状态码：200** 表5响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-Request-Id | String | 请求ID。 | 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | job_id | String | 任务ID。 | | training_video_upload_url | Array of strings | 分身数字人训练视频上传URL。该url在文件上传成功后失效，只能上传一次。注意：视频必须是1080p或者4K分辨率（横、竖屏皆可）的mp4格式，视频长度须大于等于3分钟且小于等于10分钟，否则审核会不通过。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | | action_video_upload_url | Array of strings | 分身数字人训练视频上传URL。该url在文件上传成功后失效，只能上传一次。注意：视频必须是1080p或者4K分辨率（横、竖屏皆可）的mp4格式，视频长度须大于等于3分钟且小于等于10分钟，否则审核会不通过。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | | audio_upload_url | String | 音频数据训练上传URL。该url在文件上传成功后失效，只能上传一次 说明： 通过该地址上传时，需设置content-type为application/zip。 | | cover_upload_url | String | 模型封面上传URL。该URL在文件上传成功后失效，只能上传一次。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | | id_card_image1_upload_url | String | 身份证正面照片上传URL。该URL在文件上传成功后失效，只能上传一次。注意：非NA用户必须上传，否则审核会不通过。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | | id_card_image2_upload_url | String | 身份证反面照片上传URL。该URL在文件上传成功后失效，只能上传一次。注意：非NA用户必须上传，否则审核会不通过。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | | grant_file_upload_url | String | 授权书上传URL。该URL在文件上传成功后失效，只能上传一次。注意：非NA用户必须上传，否则审核会不通过。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | | pre_beauty_image_upload_url | String | 美白前图片上传url。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | | post_beauty_image_upload_url | String | 美白后图片上传url。 说明： 通过该地址上传时，需设置content-type为application/octet-stream | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | #### 请求示例 ``` https://example.com/rest/v1/***/digital-human-training-manage/user/jobs { "name" : "测试角色", "contact" : "1**********", "video_multipart_count" : 2, "is_background_replacement" : true } ``` #### 响应示例 **状态码：200** 处理成功返回。 ``` { "job_id" : "efc5300ecdba4ea48d1ff13a9d907bc0", "training_video_upload_url" : [ "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_trainingVideo?parma1=XXX¶m2=YYY", "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_trainingVideo?parma1=XXX¶m2=YYY" ], "cover_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_cover?parma1=XXX¶m2=YYY", "id_card_image1_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage1_tmp?parma1=XXX¶m2=YYY", "id_card_image2_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage2_tmp?parma1=XXX¶m2=YYY", "grant_file_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_grantFile_tmp?parma1=XXX¶m2=YYY" } ``` **状态码：400** 请求传参异常，包含错误码及对应描述。 ``` { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } ``` **状态码：500** 内部服务错误。 ``` { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 处理成功返回。 | | 400 | 请求传参异常，包含错误码及对应描述。 | | 500 | 内部服务错误。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-metastudio/ErrorCode.html)。