调用 CreateHighLightTask 接口，创建高光智能剪辑任务，对公网可访问的点播视频或直播流进行高光片段提取和混剪，并上传至指定空间，可根据算法模型自动生成高光片段或高光混剪视频。接口提供丰富的配置选项，包括输出格式、冗余时间等，适用于体育赛事等场景的内容智能剪辑需求。

注意事项 #

• 前提条件：需要将高光素材存放在点播平台时，请先开通点播服务，参考空间管理创建空间。同时需点击链接，确保完成对点播空间的跨服务授权。
• 请求频率：单用户请求频率限制为 10 次/秒。
• 费用和限制：该功能当前处于邀测阶段，暂不计费，仅授权账户可用。若需获取授权，请联系技术支持。
• 回调消息：调用本接口开启回调通知后，系统将向您发送回调消息。详细参数说明请参见高光剪辑回调消息说明。
• 素材时长：无论数据源类型为直播流还是点播视频，单次处理的素材时长上限均为 3 小时。

请求说明 #

• 请求方式：POST
• 请求地址：https://live.volcengineapi.com?Action=CreateHighLightTask&Version=2023-01-01

调试 #

请求参数 #

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query #

Body #

Sources #

HLClipsParam #

HLMixParam #

LiveParam #

VodParam #

CallbackParam #

HttpParams #

返回参数 #

下表仅列出本接口特有的返回参数。更多信息请见返回结构。

Data #

请求示例 #

创建直播高光剪辑任务实例

POST https://live.volcengineapi.com?Action=CreateHighLightTask&Version=2023-01-01
{
    "Name": "足球高光剪辑",
    "Type": 0,
    "Model": 0,
    "Sources": [
        {
            "Path": "http://example.com/live/stream.flv",
            "SourceType": 0
        }
    ],
    "HLMixParam": {
        "Enable": true,
        "CreateTimestamps": [
            2,
            4,
            6
        ]
    },
    "HLClipsParam": {
        "Enable": true,
        "OutputHLClips": true
    },
    "LiveParam": {
        "TaskStartTime": "2023-01-01T08:40:00+08:00",
        "TaskEndTime": "2023-01-01T10:40:00+08:00"
    },
    "VodParam": {
        "Space": "HighLight"
    },
    "CallbackParam": {
        "CallbackType": 0,
        "HttpParams": {
            "CallbackAdr": "http://example.com/callback"
        },
        "CallbackExtra": "extra data"
    }
}

返回示例 #

{
    "ResponseMetadata": {
        "RequestID": "202502281605280C****E3D60D7A21CEAE"
    },
    "Result": {
        "Code": 0,
        "Message": "success",
        "Data": {
            "TaskID": "dd311d****2d91e3"
        }
    }
}

错误码 #

下表仅列出本接口特有的错误码。更多信息请参见公共错误码获取详细信息。