通过TaskId来查询任务的制作进度和结果。
调用协议
HTTPS + JSON
POST /v2/ivh/assetmanager/customservice/getprogress
Header Content-Type: application/json;charset=utf-8
请求参数
参数 | 类型 | 必须 | 说明 |
TaskId | string | 是 |
返回参数
参数 | 类型 | 必须 | 说明 |
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: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 | 否 | |
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"}}