作用

当媒资库中的视频转码完成后，企业直播会对所设置的接口地址进行回调通知。在以下情况下，会触发视频转码：

• 调用 UploadMediaByURL 接口或通过控制台上传视频至视频库
• 直播结束后自动生成直播录制视频
• 调用 MediaCut 接口或通过云剪辑功能剪辑视频
• 调用 MediasMergeAPI 接口合并回放视频
• 通过直播伴侣云端录制生成视频

配置方式

完成回调配置。详见回调配置。

详情

完成回调配置后，视频转码完成时，企业直播会将视频的 Vid、视频清晰度等数据以 POST 方式提交给您设置的回调地址。
转码规则如下：

• 转码输出格式为 MP4。
• 每次视频转码，会触发两次回调通知，通知的先后顺序不固定：
  • 当系统生成 1080p 转码版本时，发送一次回调通知；
  • 当系统生成 720p 转码版本时，发送一次回调通知。

    说明

    若源视频的短边分辨率 ≤ 540 像素，则 720p 的视频将转码失败，同时系统发送的回调通知中将显示转码失败。

请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": "2*****41",
    "Definition": "1080p",
    "EventType": "VideoTranscodeFinished",
    "RequestUuid": "VideoTranscodeFinished-184****7305",
    "Sign": "3635504c*******1d0818e",
    "Source": "1",
    "Status": "0",
    "SubAccountName": "admin@bytedance.com",
    "Timestamp": "1758354301",
    "Vid": "v0c251g*******packem16g"
}

超时重试

回调服务器在发送消息通知后，5 秒内没有收到您的服务器的响应，即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数