tencent cloud

文档反馈

音视频制作进度查询接口

最后更新时间: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
    }
    ]
    }
    ]
    }
    }
     
    联系我们

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

    技术支持

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

    7x24 电话支持