文档首页/ 数字内容生产线 MetaStudio/ API参考/ 分身形象制作管理/ 创建分身数字人模型训练任务
更新时间：2024-12-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建分身数字人模型训练任务

功能介绍

该接口用于创建分身数字人模型训练任务。

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/digital-human-training-manage/user/jobs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID。

请求参数

表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和V2版本已废弃不用

取值范围：

0-64

默认取值：

V3.2

is_flexus

否

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

该任务所生成的模型支持的业务类型，可多选

默认取值：

[VIDEO_2D,LIVE_2D]
表4 VoiceProperties

参数

是否必选

参数类型

描述

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&param2=YYY", "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_trainingVideo?parma1=XXX&param2=YYY" ],
  "cover_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_cover?parma1=XXX&param2=YYY",
  "id_card_image1_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage1_tmp?parma1=XXX&param2=YYY",
  "id_card_image2_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage2_tmp?parma1=XXX&param2=YYY",
  "grant_file_upload_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_grantFile_tmp?parma1=XXX&param2=YYY"
}

状态码： 400

{
  "error_code" : "MSS.00000003",
  "error_msg" : "Invalid parameter"
}

状态码： 500

{
  "error_code" : "MSS.00000004",
  "error_msg" : "Internal Error"
}

状态码

状态码

描述

200

处理成功返回。

400

请求传参异常，包含错误码及对应描述。

500

内部服务错误。

错误码

请参见错误码。

父主题： 分身形象制作管理