查询分身数字人模型训练任务详情 - Show2dModelTrainingJob
功能介绍
该接口用于查询分身数字人模型训练任务详情。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/digital-human-training-manage/user/jobs/{job_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID。 |
|
job_id |
是 |
String |
任务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。不允许输入中文。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
X-Request-Id |
String |
请求ID。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
job_id |
String |
任务ID。 |
|
name |
String |
分身数字人模型名称。该名称会作为资产库中分身数字人模型资产名称。 |
|
state |
String |
任务的状态。 与MetaStudio Console上用户看到的状态映射关系如下：
|
|
asset_id |
String |
模型资产ID。 |
|
project_id |
String |
模型资产所属项目ID。 |
|
cover_download_url |
String |
分身数字人模型封面下载URL。URL有效期24小时。 |
|
last_update_time |
String |
用户最近一次更新任务的时间（包括租户创建或者重新提交），格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z” |
|
create_time |
String |
创建时间，格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z” |
|
contact |
String |
分身数字人训练任务创建者的手机号。 |
|
batch_name |
String |
分身数字人训练任务的批次名称。 |
|
tags |
Array of strings |
分身数字人训练任务标签。 |
|
model_version |
String |
分身数字人模型版本。默认是V3.2版本模型。
说明：
取值范围： 0~64 默认取值： V3.2 |
|
matting_type |
String |
抠图类型。默认是AI。
默认取值： AI |
|
model_resolution |
String |
分身数字人模型分辨率。默认是1080P。
默认取值： 1080P |
|
app_user_id |
String |
自定义用户id（如创建任务时设置了X-App-UserId则会携带）。 |
|
is_flexus |
Boolean |
是否是基础版的形象训练 |
|
is_live_copy |
Boolean |
是否是直播间复刻任务 |
|
is_fast_flexus |
Boolean |
是否极速版flexus 默认取值： false |
|
is_only_human_model |
Boolean |
是否只训练形象模型，不训练声音模型。仅Flexus版本时有效，默认false。 默认取值： false |
|
optional_training_location |
Array of strings |
可选训练region |
|
is_background_replacement |
Boolean |
分身数字人是否需要背景替换。需要背景替换的分身数字人训练视频需要绿幕拍摄。 默认取值： true |
|
is_ondemand_resource |
Boolean |
是否按需任务 默认取值： false |
|
training_video_download_url |
String |
分身数字人训练视频下载URL。24小时内有效。 |
|
id_card_image1_download_url |
String |
身份证正面照片下载URL。24小时内有效。 |
|
id_card_image2_download_url |
String |
身份证反面照片下载URL。24小时内有效。 |
|
grant_file_download_url |
String |
授权书下载URL。24小时内有效。 |
|
pre_beauty_image_download_url |
String |
美白前图片下载url。 |
|
external_action_json_data_download_url |
String |
授权书下载URL。24小时内有效。 |
|
action_video_download_url |
String |
动作视频 |
|
post_beauty_image_download_url |
String |
美白后图片下载url。 |
|
audio_file_download_url |
String |
音频文件下载url。 |
|
action_mark_file_download_url |
String |
动作标定文件下载url。 |
|
action_mark_file_upload_url |
String |
动作标定文件上传url。 |
|
operation_logs |
Array of OperationLogInfo objects |
操作日志列表。 |
|
verify_video_matting_info |
Array of VerifyVideoMattingInfo objects |
生成抠图验证视频时不抠图区域。 |
|
comment_logs |
Array of CommentLogInfo objects |
评论记录列表。 |
|
samples |
Array of ActionSampleInfo objects |
动作视频样例。 |
|
is_mask_file_uploaded |
Boolean |
遮罩文件是否已上传。 |
|
mask_file_download_url |
String |
遮罩下载URL。24小时内有效。 |
|
verify_video_download_url |
String |
制作审核视频 |
|
markable_video_download_url |
String |
标注视频url下载链接。24小时内有效。 |
|
markable_action_video_download_url |
String |
动作标注视频url下载链接。24小时内有效。 |
|
traning_video_mark_info |
TrainingVideoMarkInfo object |
分身数字人训练视频标记信息。 |
|
inference_data_process_video_mark_info |
InferenceVideoMarkInfo object |
分身数字人推理预处理视频标记信息。 |
|
voice_properties |
VoiceProperties object |
分身数字人推理预处理视频标记信息。 |
|
inference_data_process_action_mark_info |
InferenceActionMarkInfo object |
分身数字人推理预处理动作标记信息。 |
|
inference_data_process_chat_action_mark_info |
InferenceActionMarkInfo object |
分身数字人推理预处理智能交互动作标记信息。 |
|
inference_data_process_eye_correction_mark_info |
分身数字人推理预处理视频标记信息。 |
|
|
worker_type |
Array of strings |
转编译任务机型 |
|
voice_train_job_id |
String |
声音训练任务id。 |
|
flexus_retry_count |
Integer |
flexus版本任务剩余可以重训的次数，每重训一次减1，减到0时不可再重训。 取值范围： 0~10 |
|
audio_source_type |
String |
声音来源类型
|
|
supported_service |
Array of strings |
该任务所生成的模型支持的业务类型，可多选。 Flexus版数字人仅支持选择“VIDEO_2D”。 默认取值： [VIDEO_2D,LIVE_2D] |
|
allocated_resource |
TrainingAllocatedResource object |
形象训练分配的资源。 |
|
train_video_rotation_state |
String |
训练视频旋转任务状态。
|
|
action_video_rotation_state |
String |
训练视频旋转任务状态。
|
|
sub_training_job_info |
Array of SubTrainingJobInfoDto objects |
子任务信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
operate_time |
String |
操作时间,格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z” |
|
log_type |
String |
命令执行结果。
|
|
log_description |
String |
日志描述。用于记录人工或自动审核不通过时的审核意见。 |
|
operate_user |
String |
操作人员。
|
|
error_code |
String |
系统自动驳回时的错误码：
|
|
redo_reasons |
Array of strings |
任务被管理员重新执行的问题原因列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
dx |
Integer |
区域左上角像素点的X轴位置值。 取值范围： 0~3840 |
|
dy |
Integer |
区域左上角像素点的Y轴位置值。 取值范围： 0~3840 |
|
width |
Integer |
区域宽度像素值。 取值范围： 1~7680 |
|
height |
Integer |
区域高度像素值。 取值范围： 1~7680 |
|
method |
String |
资源操作类型。
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
operate_time |
String |
操作时间,格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z” |
|
comment_type |
String |
|
|
comment_title |
String |
标题。 |
|
comment_message |
String |
消息。 |
|
attachment_download_url |
Array of strings |
附件下载地址 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
action_name_zh |
String |
原子动作中文名称。 |
|
action_name_en |
String |
原子动作英文名称。 |
|
action_tag |
String |
动作Tag。 |
|
catalog |
String |
动作分类名称。 |
|
recommended_value |
Integer |
推荐等级。 取值范围： 0~100 |
|
is_selected |
Boolean |
是否选择此动作。 默认取值： true |
|
sample_download_url |
String |
原子动作样例文件下载地址。24小时内有效。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
video_start_time |
String |
训练视频起始时间。格式：“HH:MM:SS.mmm”。 |
|
video_end_time |
String |
训练视频结束时间。格式：“HH:MM:SS.mmm”。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
video_start_time |
String |
选取推理数据预处理视频起始时间。格式：“HH:MM:SS.mmm”。 |
|
video_end_time |
String |
选取推理数据预处理视频结束时间。格式：“HH:MM:SS.mmm”。 |
|
chat_video_start_time |
String |
选取推理数据预处理智能交互视频起始时间。格式：“HH:MM:SS.mmm”。 |
|
chat_video_end_time |
String |
选取推理数据预处理智能交互视频结束时间。格式：“HH:MM:SS.mmm”。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
job_tag |
String |
任务标签，为Flexus版声音的配置。
|
|
sex |
String |
语音性别，是男性声音还是女性声音，为Flexus版声音的配置。
默认取值： FEMALE |
|
language |
String |
训练语言，当前仅支持中文，为Flexus版声音的配置。
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
action_start_time |
String |
选取推理数据预处理视频起始时间。格式：“HH:MM:SS.mmm”。 |
|
action_end_time |
String |
选取推理数据预处理视频结束时间。格式：“HH:MM:SS.mmm”。 |
|
action_type |
String |
动作类型。
取值范围： 0~64 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
eye_correction_start_time |
String |
选取推理数据预处理眼神矫正起始时间。格式：“HH:MM:SS.mmm”。 |
|
eye_correction_end_time |
String |
选取推理数据预处理眼神矫正结束时间。格式：“HH:MM:SS.mmm”。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
resource_id |
String |
资源ID。 |
|
charge_mode |
String |
资源计费类型。
说明：
|
|
expire_time |
String |
资源过期时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z" |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
job_id |
String |
任务id |
|
sub_job_type |
String |
子任务类型 |
|
heart_beat_id |
String |
子任务心跳id |
|
state |
String |
任务状态 |
|
create_time |
Long |
创建时间 |
|
last_update_time |
Long |
最后更新时间 |
状态码：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/efc5300ecdba4ea48d1ff13a9d907bc0
响应示例
状态码：200
处理成功返回。
{
"job_id" : "efc5300ecdba4ea48d1ff13a9d907bc0",
"name" : "测试名字",
"state" : "MANUAL_VERIFYING",
"project_id" : "***",
"cover_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_cover?param1=XXX¶m2=YYY",
"create_time" : "2023-12-09T07:31:37Z",
"contact" : "1**********",
"model_version" : "V3",
"matting_type" : "AI",
"model_resolution" : "1080P",
"training_video_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_trainingVideo?param1=XXX¶m2=YYY",
"id_card_image1_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage1?param1=XXX¶m2=YYY",
"id_card_image2_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage2?param1=XXX¶m2=YYY",
"grant_file_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_grantFile?param1=XXX¶m2=YYY",
"operation_logs" : [ {
"operate_time" : "2023-12-09T07:31:37Z",
"log_type" : "USER_CREATE_JOD",
"operate_user" : "USER"
}, {
"operate_time" : "2023-12-09T07:31:43Z",
"log_type" : "SYSTEM_MARKABLE_VIDEO",
"operate_user" : "SYSTEM"
}, {
"operate_time" : "2023-12-09T07:31:43Z",
"log_type" : "USER_VERIFYING_SUBMITTED",
"operate_user" : "USER"
}, {
"operate_time" : "2023-12-09T07:31:43Z",
"log_type" : "SYSTEM_VERIFY_SUCCESS",
"operate_user" : "SYSTEM"
}, {
"operate_time" : "2023-12-09T07:32:45Z",
"log_type" : "SYSTEM_MARKABLE_VIDEO_SUCCESS",
"operate_user" : "SYSTEM"
} ],
"comment_logs" : [ ],
"is_mask_file_uploaded" : false,
"verify_video_download_url" : "null",
"markable_video_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_markableData?param1=XXX¶m2=YYY",
"is_background_replacement" : true
}
状态码：400
请求传参异常，包含错误码及对应描述。
{
"error_code" : "MSS.00000003",
"error_msg" : "Invalid parameter"
}
状态码：500
内部服务错误。
{
"error_code" : "MSS.00000004",
"error_msg" : "Internal Error"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
处理成功返回。 |
|
400 |
请求传参异常，包含错误码及对应描述。 |
|
500 |
内部服务错误。 |
错误码
请参见错误码。
