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

查询分身数字人模型训练任务详情

功能介绍

该接口用于查询分身数字人模型训练任务详情。

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

job_id

是

String

任务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。不允许输入中文。

响应参数

状态码： 200

表3 响应Header参数

参数

参数类型

描述

X-Request-Id

String

请求ID。
表4 响应Body参数

参数

参数类型

描述

job_id

String

任务ID。

name

String

分身数字人模型名称。该名称会作为资产库中分身数字人模型资产名称。

state

String

任务的状态。

与MetaStudio Console上用户看到的状态映射关系如下：

  • 待提交

    • WAIT_FILE_UPLOAD: 待上传文件

  • 系统审核中

    • AUTO_VERIFYING: 自动审核中

    • MANUAL_VERIFYING: 人工审核中

  • 系统审核未通过

    • AUTO_VERIFY_FAILED: 自动审核失败

    • MANUAL_VERIFY_FAILED: 人工审核失败

  • 算法训练中

    说明：

    算法训练中的状态仅管理员需要处理，普通用户仅需要显示“算法训练中”即可。

    • MANUAL_VERIFY_SUCCESS: 审核通过，等待预处理资源

    • WAIT_TRAINING_DATA_PREPROCESS: 等待训练数据预处理

    • TRAINING_DATA_PREPROCESSING: 训练数据预处理中

    • TRAINING_DATA_PREPROCESS_FAILED: 训练数据预处理失败

    • TRAINING_DATA_PREPROCESS_SUCCESS: 训练数据预处理完成，等待训练资源中

    • TRAINING: 训练中

    • TRAIN_FAILED: 训练失败

    • TRAIN_SUCCESS: 训练完成，等待预处理资源

    • INFERENCE_DATA_PREPROCESSING: 推理数据预处理中

    • INFERENCE_DATA_PREPROCESS_FAILED: 推理数据预处理失败

    • WAIT_MAIN_FILE_UPLOAD: 等待主文件上传

    • MANUAL_STOP_INFERENCE_DATA_PREPROCESS: 人工中止推理预处理

    • MANUAL_STOP_TRAIN: 人工中止训练

    • MANUAL_STOP_TRAINING_DATA_PREPROCESS: 人工中止训练预处理

    • WAIT_ADMIN_CONFIRM: 等待管理员审核

    • WAIT_COMPILE: 等待转编译

    • COMPILING: 转编译中

    • COMPILE_FAILED: 转编译失败

    • WAIT_GENERATE_ACTION: 等待原子动作生成

    • WAIT_ARRANGE: 等待编排

    • ACTION_GENERATE_DATA_PROCESSING: 原子动作生成中

    • MANUAL_STOP_ACTION_GENERATE_DATA_PROCESSING: 人工中止动作生成

    • MANUAL_STOP_ACTION_GENERATE_ORI_PROCESSING: 人工中止动作编排

    • ACTION_GENERATE_ORI_PROCESSING: 动作编排中

    • ACTION_GENERATE_DATA_FAILED: 动作生成失败

    • ACTION_GENERATE_ORI_FAILED: 生成动作编排资产失败

    • ACTION_GENERATE_ORI_SUCCESS: 动作编排成功

    • GENERATE_ACTION_PREPROCESS_FAILED: 生成动作编排原子动作失败

    • WAIT_ADMIN_CALIBRATION: 等待管理员确认动作信息

    • WAIT_ASSET_SYNC: 等待资产同步

  • 待用户审核，仅NA白名单用户有该状态

    • WAIT_USER_CONFIRM: 等待用户确认训练效果

  • 用户驳回，仅NA白名单用户有该状态

    • JOB_REJECT: 驳回任务

  • 已完成

    • JOB_SUCCESS: 训练任务完成（普通用户任务的完成状态，此时用户已经可以使用模型）

    • JOB_FINISH: 任务结束，是最终状态，不支持修改此状态(NA用户任务的完成状态，并且此状态表明模型效果已通过用户的验收)

  • 挂起，仅NA白名单用户有该状态

    • JOB_PENDING: 挂起任务

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版本模型。

  • V3.2：V3.2版本模型

说明：

  • V3和V2版本已废弃不用

取值范围：

0-64

默认取值：

V3.2

matting_type

String

抠图类型。默认是AI。

  • AI：AI抠图

  • MANUAL：人工抠图

默认取值：

AI

model_resolution

String

分身数字人模型分辨率。默认是1080P。

  • 1080P：1080P。支持1080P及720P的视频输出。

  • 4K：4K。支持4K、1080P及720P的视频输出。

默认取值：

1080P

app_user_id

String

自定义用户id（如创建任务时设置了X-App-UserId则会携带）。

is_flexus

Boolean

是否是基础版的形象训练

is_only_human_model

Boolean

是否只训练形象模型，不训练声音模型。仅Flexus版本时有效，默认false。

默认取值：

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。

action_video_download_url

String

动作视频

post_beauty_image_download_url

String

美白后图片下载url。

audio_file_download_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小时内有效。

traning_video_mark_info

TrainingVideoMarkInfo object

分身数字人训练视频标记信息。

inference_data_process_video_mark_info

InferenceVideoMarkInfo 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

InferenceEyeCorrectionMarkInfo object

分身数字人推理预处理视频标记信息。

is_background_replacement

Boolean

分身数字人是否需要背景替换。需要背景替换的分身数字人训练视频需要绿幕拍摄。

默认取值：

true

worker_type

Array of strings

转编译任务机型

voice_train_job_id

String

声音训练任务id。

flexus_retry_count

Integer

flexus版本任务剩余可以重训的次数，每重训一次减1，减到0时不可再重训。

取值范围：

0-10

audio_source_type

String

声音来源类型

  • VIDEO：视频中抽取音频

  • AUDIO：单独上传的音频

supported_service

Array of strings

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

默认取值：

[VIDEO_2D,LIVE_2D]

allocated_resource

TrainingAllocatedResource object

形象训练分配的资源。
表5 OperationLogInfo

参数

参数类型

描述

operate_time

String

操作时间,格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”

log_type

String

命令执行结果。

  • USER_CREATE_JOD：用户开始分身数字人定制

  • USER_VERIFYING_SUBMITTED：用户提交审核

  • SYSTEM_VERIFY_FAILED：自动审核失败

  • ADMIN_UPDATE_BEAUTY_LEVEL：管理员更新美白等级

  • SYSTEM_VERIFY_SUCCESS：自动审核成功

  • ADMIN_VERIFY_SUCCESS：人工审核通过

  • ADMIN_VERIFY_FAILED：人工审核不通过

  • SYSTEM_TRAIN_DATA_PREPROCESSING：训练数据预处理中

  • SYSTEM_TRAIN_DATA_PREPROCESS_FAILED：训练数据预处理失败

  • SYSTEM_TRAIN_DATA_PREPROCESS_SUCCESS：训练数据预处理成功

  • SYSTEM_ACTION_GENERATE_DATA_PREPROCESSING：动作编排原子动作生成中

  • SYSTEM_ACTION_GENERATE_DATA_SUCCESS：动作编排原子动作生成成功

  • SYSTEM_ACTION_GENERATE_ORI_SUCCESS：动作编排资产数据生成成功

  • SYSTEM_ACTION_GENERATE_DATA_FAILED：动作编排原子动作生成失败

  • SYSTEM_ACTION_GENERATE_ORI_FAILED：动作编排资产数据生成失败

  • SYSTEM_ACTION_GENERATE_ORI_PREPROCESSING：动作编排资产数据生成中

  • SYSTEM_TRAINING：开始训练

  • ADMIN_STOP_TRAINING_DATA_PREPROCESS：人工中止训练

  • ADMIN_STOP_BEAUTY_PREPROCESS：人工中止美白

  • ADMIN_STOP_INFERENCE_DATA_PREPROCESS：人工中止推理预处理

  • ADMIN_STOP_TRAIN：人工终止训练

  • SYSTEM_TRAIN_FAILED：训练失败

  • SYSTEM_TRAIN_SUCCESS：训练成功

  • SYSTEM_INFERENCE_DATA_PREPROCESSING：推理数据预处理中

  • SYSTEM_INFERENCE_DATA_PREPROCESS_FAILED：推理数据预处理失败

  • SYSTEM_INFERENCE_DATA_PREPROCESS_SUCCESS：推理数据预处理成功

  • SYSTEM_JOB_SUCCESS：任务处理完成

  • ADMIN_MASK_UPLOADED：遮罩文件上传完成（已废弃）

  • ADMIN_UPDATE_VIDEO：管理员更换视频

  • ADMIN_UPDATE_ACTION_VIDEO：管理员更换动作编排视频

  • ADMIN_RESET：管理员一键重置

  • ADMIN_ACCEPT：管理员通过

  • USER_REPAIR：用户修复

  • SYSTEM_UPDATE_COVER：更换封面

  • ADMIN_SET_SILENCE_REPEAT_NUM：管理员设置静默轮数

  • SYSTEM_MARKABLE_VIDEO：标记视频生成任务

  • SYSTEM_MASK_VERIFY_VIDEO：校验视频生成任务

  • SYSTEM_MASK_VERIFY_VIDEO_SUCCESS：校验视频生成成功

  • SYSTEM_MASK_VERIFY_VIDEO_FAILED：校验视频生成失败

  • SYSTEM_MARKABLE_VIDEO_SUCCESS：标记视频生成成功

  • SYSTEM_BEAUTY_PREPROCESSING：美白处理中

  • SYSTEM_BEAUTY_PREPROCESS_FAILED：美白处理失败

  • ADMIN_CONFIRM_ACTION：管理员确认动作

  • ADMIN_STOP_ACTION_GENERATE_DATA_PREPROCESS：人工中止原子动作生成

  • ADMIN_STOP_ACTION_GENERATE_ORI_PREPROCESS：人工中止动作编排

  • SYSTEM_BEAUTY_PREPROCESS_SUCCESS：美白视频训练预处理成功

  • SYSTEM_COMPILE_FAILED：转编译失败

  • SYSTEM_COMPILE_SUCCESS：转编译成功

  • SYSTEM_MARKABLE_VIDEO_FAILED：标记视频生成失败

  • ADMIN_UPDATE_COMPILE：管理员更新转编译配置

  • ADMIN_UPDATE_INFERENCE_DATA_PROCESS_VIDEO：管理员更新推理预处理时间段信息

  • SYSTEM_EXECUTE_COMPILE：执行转编译

  • SYSTEM_EXECUTE_BEAUTY：执行美白处理

  • SYSTEM_MASK_VIDEO_AND_ACTION_TIME_SUCCESS：自动标记成功

  • SYSTEM_MASK_VIDEO_AND_ACTION_TIME_FAILED：自动标记失败

  • USER_UPDATE_VIDEO：用户更换视频

  • ADMIN_UPDATE_GENERAL_CONFIG：管理员更新通用配置

  • ADMIN_MASK_ACTION_TIME：管理员标记

  • STOP_COMPILE：人工中止转编译

log_description

String

日志描述。用于记录人工或自动审核不通过时的审核意见。

operate_user

String

操作人员。

  • USER：用户

  • ADMIN：管理员

  • SYSTEM：系统

error_code

String

系统自动驳回时的错误码：

  • 44005901：视频分辨率不符合要求，目前只接受 1080p(1920x1080, 1080x1920) 或 4K(3840x2160, 2160x3840) 这四种分辨率
表6 VerifyVideoMattingInfo

参数

参数类型

描述

dx

Integer

区域左上角像素点的X轴位置值。

取值范围：

0-3840

dy

Integer

区域左上角像素点的Y轴位置值。

取值范围：

0-3840

width

Integer

区域宽度像素值。

取值范围：

1-7680

height

Integer

区域高度像素值。

取值范围：

1-7680

method

String

资源操作类型。

  • RESERVED: 视频不需要抠绿的区域。

  • DELETE：视频需要抠绿的区域。

  • NO_DEGREEN：视频不需要去绿的区域。
表7 CommentLogInfo

参数

参数类型

描述

operate_time

String

操作时间,格式遵循：RFC 3339。 例 “2020-07-30T10:43:17Z”

comment_type

String

  • USER_REJECT：用户驳回

  • USER_COMMENT：用户评论

  • ADMIN_COMMENT：管理员评论

comment_title

String

标题。

comment_message

String

消息。

attachment_download_url

Array of strings

附件下载地址
表8 ActionSampleInfo

参数

参数类型

描述

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小时内有效。
表9 TrainingVideoMarkInfo

参数

参数类型

描述

video_start_time

String

训练视频起始时间。格式：“HH:MM:SS.mmm”。

video_end_time

String

训练视频结束时间。格式：“HH:MM:SS.mmm”。
表10 InferenceVideoMarkInfo

参数

参数类型

描述

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”。
表11 InferenceActionMarkInfo

参数

参数类型

描述

action_info

Array of ActionMarkItem objects

动作列表。
表12 ActionMarkItem

参数

参数类型

描述

action_start_time

String

选取推理数据预处理视频起始时间。格式：“HH:MM:SS.mmm”。

action_end_time

String

选取推理数据预处理视频结束时间。格式：“HH:MM:SS.mmm”。

action_type

String

动作类型。

  • SILENCE: 静默

  • ACTION：动作

取值范围：

0-64
表13 InferenceEyeCorrectionMarkInfo

参数

参数类型

描述

eye_correction_start_time

String

选取推理数据预处理眼神矫正起始时间。格式：“HH:MM:SS.mmm”。

eye_correction_end_time

String

选取推理数据预处理眼神矫正结束时间。格式：“HH:MM:SS.mmm”。
表14 TrainingAllocatedResource

参数

参数类型

描述

resource_id

String

资源ID。

charge_mode

String

资源计费类型。

  • PERIODIC: 包周期

  • ONE_TIME：一次性计费

说明：

  • 一次性计费包括：租户订购的一次性资源，SP管理员分配给租户的一次性资源。

expire_time

String

资源过期时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"

状态码： 400

表15 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码： 500

表16 响应Body参数

参数

参数类型

描述

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&param2=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&param2=YYY",
  "id_card_image1_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage1?param1=XXX&param2=YYY",
  "id_card_image2_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage2?param1=XXX&param2=YYY",
  "grant_file_download_url" : "https://example.com/efc5300ecdba4ea48d1ff13a9d907bc0_grantFile?param1=XXX&param2=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&param2=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

内部服务错误。

错误码

请参见错误码。

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