tencent cloud

腾讯云智能数智人

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

音视频制作进度查询接口

PDF
聚焦模式
字号
最后更新时间： 2024-07-18 18:23:43

接口说明

通过 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"状态时在该任务之前排队的任务数量
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": 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
                    }
                ]
            }
        ]
    }
}
 
上一篇: 视频制作接口-基础版下一篇: 视频制作接口-进阶版

帮助和支持

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

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

文档反馈