腾讯云智能数智人进度查询接口-服务端 API 接入-文档中心-腾讯云

通过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
否
（自2024.1.1之后发起的进度查询请求，以当前字段为准）
当 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：2D小样本-标准版（专属口型）形象定制
IMAGE_GENERAL：2D小样本-标准版（通用口型）形象定制
IMAGE_4K：2D小样本-高精版（专属口型）形象定制
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": "1212_29934_w"
  }
}
返回示例
{
  "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"
  }
}
﻿

参数	类型	必须	说明
TaskId	string	是	定制接口返回的 TaskId

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\\"]}]}`

进度查询接口

本页目录：

调用协议

请求参数

返回参数

请求示例

返回示例