tencent cloud

文档反馈

进度查询接口

最后更新时间:2024-07-18 18:11:44
    通过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"
    }
    }
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持