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

音视频制作进度查询接口

最近更新时间：2025-06-23 19:20:32

我的收藏

本页目录：

接口说明

通过 TaskId 来查询任务的制作进度和结果，当返回值里的 Progress 字段值为100时，即可通过 MediaUrl 获取最终音视频的下载地址，如果是视频制作也会返回 SubtitlesUrl 字段获取最终 SRT 字幕地址。
注意：
制作完成的视频资源默认存储在数智人内部账号的 COS 下，只保留7天，可以通过在制作接口中的 VideoStorageS3Url 字段指定第三方存储 URL，这样制作完的视频会上传到指定地址。

调用协议

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

请求参数

参数
类型
必须
说明
TaskId
String
是

返回参数

参数
类型
必须
说明
Progress
int
是
制作进度，-1~100，-1代表生成失败，100代表生成成功（预留字段，目前不具备参考意义）
MediaUrl
String
是
音视频结果地址
SubtitlesUrl
String
否
当制作视频时，返回视频对应的 SRT 字幕地址
Status
String
是
制作状态
"COMMIT"：已提交需要排队
"MAKING"：制作中
"SUCCESS"：制作成功
"FAIL"：制作失败
ArrayCount
int
是
Status 为 "COMMIT" 状态时在该任务之前排队的任务数量
FailCode
int
否
FailMessage
String
否
制作失败返回的失败原因，便于排查问题
TextTimestampResult
Array of [Sentence]
否
该字段返回 TTS 试听任务的文本时间戳信息
Duration
int
是
视频时长，单位 ms
Sentence
参数
类型
必须
说明
Sentence
String
是
拆句得出的句子
Words
Array of [Word]
是
句子中每个字的信息
Word
参数
类型
必须
说明
Word
String
是
句子中的一个字
StartTimestamp
long
是
该字的时间起点，该数值/10000为 ms，相当于单位为 0.1us
EndTimestamp
long
是
该字的时间尾点，该数值/10000为 ms，相当于单位为 0.1us

请求示例

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

返回示例

{
    "Header": {
        "Code": 0,
        "Message": "",
        "RequestID": "fde854eaa981c7f2f7285d1c7eca335b"
        "SessionID": "gzb7dec22117297528294581119"
    },
    "Payload": {
        "Progress": 100,
        "MediaUrl": "https://videomaker-resources.ivh.qq.com/81883d47c6154edf8e276531f09227b6.mp3",
        "SubtitlesUrl": "",
        "ArrayCount": 0,
        "FailMessage": "",
        "Duration": 11810,
        "FailCode": 0,
        "TextTimestampResult": [
            {
                "Sentence": "你好虚拟主播。",
                "Words": [
                    {
                        "Word": "你",
                        "EndTimestamp": 6100000,
                        "StartTimestamp": 4500000
                    },
                    {
                        "Word": "好",
                        "EndTimestamp": 8200000,
                        "StartTimestamp": 6100000
                    },
                    {
                        "Word": "虚",
                        "EndTimestamp": 9700000,
                        "StartTimestamp": 8200000
                    },
                    {
                        "Word": "拟",
                        "EndTimestamp": 11100000,
                        "StartTimestamp": 9700000
                    },
                    {
                        "Word": "主",
                        "EndTimestamp": 12900000,
                        "StartTimestamp": 11100000
                    },
                    {
                        "Word": "播。",
                        "EndTimestamp": 16000000,
                        "StartTimestamp": 12900000
                    }
                ]
            }
        ]
    }
}
 
中国站
目录