tencent cloud

腾讯云智能数智人

产品简介
产品概述
产品功能
产品优势
购买指南
价格指南
购买指引
使用代金券购买流程
退费说明
数智人形象介绍
形象类别介绍
基础形象库
形象和声音复刻指引
数智人平台操作指引
访问平台
形象生产与资产管理
数智人会话互动应用与管理
播报数智人视频生成与管理
运营管理与分析
服务端 API 接入
数智人 API 接入模式概述
数智人 aPaas 接口调用方式
2D真人小样本形象、声音定制 API 文档
视频生成服务 API 文档
交互数智人服务 API 文档
个人资产管理 API 文档
客户端 SDK 接入
整体介绍
3D 端渲染 SDK 接入
2D 端渲染 SDK 接入
数智人 SSML 标记语言规范
相关协议
隐私协议
DSA（Data Sharing Agreement）
常见问题
文档腾讯云智能数智人服务端 API 接入2D真人小样本形象、声音定制 API 文档形象定制进度查询接口

进度查询接口

PDF
聚焦模式
字号
最后更新时间： 2024-07-18 17:52:48
通过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"
  }
}

上一篇: 定制接口下一篇: 效果确认接口

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈