You need to enable JavaScript to run this app.
文档中心
企业直播

企业直播

复制全文
下载 pdf
直播消息回调
AI 高光智剪结果回调
复制全文
下载 pdf
AI 高光智剪结果回调

作用

当高光智剪任务完成时,企业直播会向您设置的回调地址发送回调消息。

配置方式

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

详情

完成回调配置后,当高光智剪任务完成时,企业直播会将原始视频 Vid、高光智剪任务 ID、高光片段详情列表等信息以 POST 方式提交给您设置的回调地址。

请求示例如下所示:

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": "2000000****",
    "EventType": "HighLightClipResultCallback",
    "HighlightClipJobId": "35",
    "RequestUuid": "HighLightClipResultCallback-1870000****",
    "Sign": "23a3d59b66c79c89684f6422938****",
    "SubAccountName": "admin@bytedance.com",
    "Vid": "v0c251g7007acv44sdvog65gj******",
    "Status": 1,
    "HighlightClipVideoList": [
        {
            "VideoDesc": "两名身着深色古装的男子将一名穿浅紫色衣裙的女子拖拽到厅堂中央。",
            "StartTime": 10840,
            "EndTime": 13740
        },
        {
            "VideoDesc": "女子站在厅堂中央与众人对峙,神情紧张。",
            "StartTime": 25280,
            "EndTime": 29120
        },
        {
            "VideoDesc": "男子转身看向身后众人,现场气氛发生变化。",
            "StartTime": 43600,
            "EndTime": 47160
        },
        {
            "VideoDesc": "女子低头整理衣袖,随后抬头回应对方。",
            "StartTime": 68520,
            "EndTime": 72480
        },
        {
            "VideoDesc": "众人在厅堂内围观,主角之间继续交谈。",
            "StartTime": 91840,
            "EndTime": 95720
        },
        {
            "VideoDesc": "男子走到女子身侧,画面切换至近景。",
            "StartTime": 126400,
            "EndTime": 130200
        },
        {
            "VideoDesc": "女子回望厅堂门口,众人表情出现变化。",
            "StartTime": 158760,
            "EndTime": 162680
        },
        {
            "VideoDesc": "主角站在厅堂中央,事件进入新的转折。",
            "StartTime": 194360,
            "EndTime": 198120
        }
    ]
}

超时重试

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

参数

参数类型说明
AccountIdString账号 ID。
EventTypeString回调通知的事件类型,固定取值为 HighLightClipResultCallback。
HighlightClipJobIdString高光智剪任务 ID。
RequestUuidString请求回调的唯一标识。

Sign

String

校验签名。

完成以下步骤,计算校验签名。

  1. 按照 AccountSecret、AccountId、HighlightClipJobId、EventType、Vid 的顺序,拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

说明

AccountSecret 的取值可通过控制台获取。详见步骤二:获取鉴权密钥。

SubAccountNameString创建任务的子账号。参数值 admin@bytedance.com 表示任务为主账号创建。
VidString原始视频 Vid。

Status

Integer

高光智剪任务的结果。取值如下:

  • 1:成功
  • 2:失败
HighlightClipVideoListArray of HighlightClipVideo高光片段详情列表。

HighlightClipVideo

参数类型说明
VideoDescStringAI 智剪的高光片段的内容描述。
StartTimeLong高光片段在原视频中的开始时间,单位为毫秒。
EndTimeLong高光片段在原视频中的结束时间,单位为毫秒。
最近更新时间:2026.10.10 11:17:10
这个页面对您有帮助吗?
有用
有用
无用
无用