腾讯云智能数智人
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯云智能数智人 > 服务端 API 接入 > 视频生成服务 API 文档-v4.9.7 > 音视频制作进度查询接口

音视频制作进度查询接口

最近更新时间：2023-08-08 10:39:01

我的收藏

本页目录：

接口说明

通过TaskId来查询任务的制作进度和结果，当返回值里的 progress 字段值为100时，即可通过 MediaUrl 获取最终音视频的下载地址，如果是视频制作也会返回SubtitlesUrl 字段获取最终SRT字幕地址。未上传自定义存储url的音视频资源只保留7天。

调用协议

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"状态时在该任务之前排队的任务数量
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": 123
    }
}

返回示例

{
    "Header": {
        "Code": 0,
        "Message": "",
        "RequestID": "123"
    },
    "Payload": {
        "Progress": 100,
        "MediaUrl": "url",
        "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"
                    }
                ]
            }
        ]
    }
}
 
中国站