创建分身数字人模型训练任务
功能介绍
该接口用于创建分身数字人模型训练任务。
调用方法
请参见如何调用API。
URI
POST /v1/{project_id}/digital-human-training-manage/user/jobs
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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。不允许输入中文。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
分身数字人模型名称。该名称会作为资产库中分身数字人模型资产名称。 |
|
contact |
否 |
String |
分身数字人训练任务创建者的手机号。 |
|
command_message |
否 |
String |
命令类型：
取值范围： 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版本模型。
 说明：
取值范围： 0-64 默认取值： V3.2 |
|
is_flexus |
否 |
Boolean |
是否是基础版的形象训练 默认取值： false |
|
is_only_human_model |
否 |
Boolean |
是否只训练形象模型，不训练声音模型。仅Flexus版本时有效，默认false。 默认取值： false |
|
audio_source_type |
否 |
String |
声音来源类型
默认取值： VIDEO |
|
voice_properties |
否 |
VoiceProperties object |
声音配置信息，为Flexus版声音的配置项，标准版声音不支持此配置。 |
|
supported_service |
否 |
Array of strings |
该任务所生成的模型支持的业务类型，可多选。 Flexus版数字人仅支持选择“VIDEO_2D”。 默认取值： [VIDEO_2D,LIVE_2D] |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
X-Request-Id |
String |
请求ID。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
内部服务错误。 |
错误码
请参见错误码。
