腾讯云智能数智人
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 腾讯云智能数智人 > 服务端 API 接入 > 2D真人小样本形象、声音定制 API 文档-v0.2.1 > 形象定制 > 进度查询接口

进度查询接口

最近更新时间：2024-04-23 15:07:01

我的收藏

本页目录：

通过TaskId来查询任务的制作进度和结果。

调用协议

HTTPS + JSON POST /v2/ivh/assetmanager/customservice/getprogress Header Content-Type: application/json;charset=utf-8

请求参数

参数
类型
必须
说明
TaskId
string
是
定制接口返回的 TaskId
返回参数
参数
类型
必须
说明
Status
string
是
任务制作状态：
MAKING：进行中
SUCCESS：制作成功
FAIL：制作失败
FailMessage
string
否
当 Status：FAIL 时，返回制作失败原因，便于排查问题
StageV2
string
否
（新版）当 Status：MAKING 时，返回任务进行中的具体阶段：
SUBMIT：素材提交
AUDIT：人工审核
PROCESS：预处理（仅形象定制有）
TRAIN：智能训练
CONFIRM：效果确认（照片定制无此阶段）
END：完成
StatusV2
string
否
当 StageV2 处于某个阶段时，该阶段的具体状态：
WAIT_PROCESS：待处理
PROCESSING：处理中
SUCCESS：成功
FAIL：失败
StageInfo
string
否
处于某个阶段的额外信息，JSON 格式的字符串，不同阶段的 JSON 格式类型见下述表格，目前只有效果确认阶段（StageV2 为 CONFIRM）有值。
AssetList
Array of [AssetInfo]
否
返回定制的形象或音色信息，目前支持返回的定制类型有： IMAGE_PHOTO：2D小样本（照片数智人）形象定制 ZERO_SHOT_VOICE：声音复刻（极速版）

不同阶段 StageInfo 额外信息见下表：
StageV2
类型
描述
示例
CONFIRM：效果确认阶段
string of [CustomerConfirmContent]
当阶段处于效果确认阶段（StageV2：CONFIRM），且状态处于待处理中时（StatusV2：WAIT_PROCESS），返回待确认效果 Demo 视频，客户可以根据返回的 Demo 视频通过调用效果确认接口对 Demo 视频效果进行认同/驳回操作
{\\"TrainResult\\":[\\"url1\\",\\"url2\\"],\\"RejectReason\\":\\"\\",\\"TrainRecord\\":[{\\"StartTime\\":\\"2023-11-01 23:00:17\\",\\"Record\\":[\\"url1\\",\\"url2\\"]}]}

CustomerConfirmContent
参数
类型
必须
说明
TrainResult
Array of [string]
是
供客户进行效果确认的 Demo 视频 url 地址
RejectReason
string
是
数智人侧不接受重训的理由
TrainRecord
Array of [TrainRecord]
否
历史训练的 Demo 视频清单
TrainRecord
参数
类型
必须
说明
StartTime
string
是
历史训练时间
Record
Array of [string]
是
历史训练的 Demo 视频 url 地址

AssetInfo
参数
类型
必须
说明
VirtualmanTypeCode
string
否
数智人类型 Code，参考附录3-数智人类型，形象定制返回
VirtualmanKey
string
否
数智人 virtualmankey，形象定制返回
Resolution
string
否
数智人分辨率，形象定制返回
OriginZoom
string
否
缩放系数，保留三位小数，形象定制返回
VirtualmanResourceId
int32
否
数智人资源 ID，形象定制返回
TimbreKey
string
否
音色key，声音复刻返回
TimbreSample
string
否
音色demo链接，声音复刻返回
MakeType
string
是
定制类型： IMAGE_PHOTO：2D小样本（照片数智人）形象定制 ZERO_SHOT_VOICE：声音复刻（极速版）


请求示例

{
  "Header": {},
  "Payload": {
    "TaskId": 666
  }
}

返回示例

{
  "Header": {
    "RequestID": "gz1a74c25f17030396653416949",
    "SessionID": "gz1a74c25f17030396653416950",
    "DialogID": "",
    "Code": 0,
    "Message": "ok"
  },
  "Payload": {
    "StageInfo": "{\\"TrainResult\\":[\\"url1\\",\\"url2\\"],\\"RejectReason\\":\\"\\",\\"TrainRecord\\":[{\\"StartTime\\":\\"2023-11-01 23:00:17\\",\\"Record\\":[\\"url1\\",\\"url2\\"]}]}",
    "Status": "MAKING",
    "StatusV2": "WAIT_PROCESS",
    "FailMessage": "",
    "StageV2": "CONFIRM"
  }
}

中国站