文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯云智能数智人>播报服务>视频生成服务 API 文档>视频制作接口- PPT 模式进度查询接口

视频制作接口- PPT 模式进度查询接口

最近更新时间：2026-04-01 18:23:31

我的收藏

本页目录：

接口说明

通过 TaskId 来查询 PPT 合成视频任务的制作进度和结果，当返回值里的 Progress 字段值为100时，即可通过 MediaUrl 获取最终视频的下载地址。
注意：
制作完成的视频资源默认存储在数智人内部账号的 COS 下，只保留7天。

调用协议

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

请求参数

参数
类型
必须
说明
TaskId
String
是
任务 ID，在 视频制作接口- PPT 模式 接口中返回。

返回参数

参数
类型
必须
说明
Progress
int
是
制作进度，-1~100，-1代表生成失败，100代表生成成功（预留字段，目前不具备参考意义）
MediaUrl
String
是
视频结果地址
Status
String
是
制作状态
"COMMIT"：已提交需要排队
"MAKING"：制作中
"SUCCESS"：制作成功
"FAIL"：制作失败
FailCode
int
否
FailMessage
String
否
制作失败返回的失败原因，便于排查问题
Duration
int
是
视频时长，单位：ms

请求示例

{
    "Header": {},
    "Payload": {
        "TaskId": "81883d47c6154edf8e276531f09227b6"
    }
}

返回示例

成功
{
    "Header": {
        "Code": 0,
        "Message": "",
        "RequestID": "fde854eaa981c7f2f7285d1c7eca335b",
        "SessionID": "gzb7dec22117297528294581119"
    },
    "Payload": {
        "Progress": 100,
        "MediaUrl": "https://videomaker-resources.ivh.qq.com/81883d47c6154edf8e276531f09227b6.mp3",
        "FailMessage": "",
        "Duration": 11810,
        "FailCode": 0
    }
}
失败
{
    "Header": {
        "RequestID": "74aabb5a4852942c300699eba39e8cb6",
        "SessionID": "gz6240ef0317651913998371486",
        "DialogID": "",
        "Code": 110006,
        "Message": "InternalError.DataNotExist:记录不存在"
    }
}

中国站