文档中心

企业直播

请输入

AI 高光智剪

CreateHighlightClipTask - 创建高光智剪任务

调用 CreateHighlightClipTask 接口，对媒资库下视频库或直播暂存中的指定视频创建高光智剪任务。创建的任务归属于调用接口的主账号或子账号。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。
前提条件：
- 确保您拥有火山引擎主账号，或具备媒资库 > 视频管理 > 视频库或直播暂存 > 可编辑权限的子账号。有关如何添加子账号，详见权限管理。
- 确保账号内有可用的大模型资源包。
- 使用子账号调用接口时，仅支持剪辑该子账号可见的视频库或直播暂存中的视频。有关如何配置子账号的可见范围，详见权限管理中可见范围相关内容。

请求说明

请求方式：POST
请求地址：https://livesaas.volcengineapi.com/?Action=CreateHighlightClipTask&Version=2023-08-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`CreateHighlightClipTask`	接口名称。当前 API 的名称为 `CreateHighlightClipTask`。
Version	String	是	`2023-08-01`	接口版本。当前 API 的版本为 `2023-08-01`。

Body

参数	类型	是否必选	示例值	描述
Vid	String	是	`v0c251g7007ada6nr77og65s9o4hv2rg`	待剪辑的视频 Vid。您可通过调用 ListActivityMediaAPI 接口获取视频的 `Vid`。说明使用子账号调用接口时，确保视频对子账号可见，且子账号具备媒资库 > 视频管理 > 视频库或直播暂存 > 可编辑权限。有关如何配置子账号的可见范围，详见权限管理中可见范围相关内容。
Scene	Integer	是	`1`	高光智剪场景。取值如下： `1`：爆款商品讲解，智能截取商品卖点片段 `2`：核心知识汇总，智能汇总关键内容 `3`：金融分析复盘，提炼行情走势与观点 `100`：自定义，根据您输入的提示词剪辑视频
CoverImage	String	是	`https://p-boe-sign.bytedance.net/tos-boe-v-c1801c/o0Cqxxx`	高光智剪任务的封面图片 URL，需包含协议头。
Title	String	是	`剪辑任务名称`	高光智剪任务的名称。
HighlightClipConfig	Object of HighlightClipConfig	是	`-`	高光智剪任务配置。
UserPrompt	String	是	`过滤视频中的重复表述、长时间沉默、卡顿口误、空镜头、闲聊内容，提取整场直播全部有效核心信息，剪辑成精简高光视频。`	用于指导高光内容识别和剪辑的提示词。针对不同场景，提示词示例如下：爆款商品讲解场景：遍历整场直播回放，自动识别所有主播详细介绍商品卖点、价格、规格、使用效果、对比优势的片段；剔除闲聊、空镜头、卡顿停顿内容；按产品出场顺序剪辑连贯高光片段，每个产品讲解片段精简紧凑，整体突出性价比与种草点。核心知识汇总场景：遍历整场直播回放，提取讲座或知识分享中的核心观点、关键方法与结尾总结；剔除重复表达、无效停顿和偏题内容，保证知识点完整连贯。金融分析复盘：提取大盘解读、板块逻辑与核心观点，过滤荐股等违规话术；保留数据依据和完整结论，按内容顺序生成行情复盘高光。自定义：过滤视频中的重复表述、长时间沉默、卡顿口误、空镜头、闲聊内容，提取整场直播全部有效核心信息，剪辑成精简高光视频。

HighlightClipConfig

参数	类型	是否必选	示例值	描述
DurationMin	Long	是	`30`	最终剪辑的单个高光片段的最短时长，单位为秒，取值须大于或等于 `0`。
DurationMax	Long	是	`60`	最终剪辑的单个高光片段的最长时长，单位为秒，取值不得超过原视频时长。
Definition	String	是	`1080p`	高光片段的清晰度。支持 `1080p` 和 `720p`。所选清晰度会影响大模型资源消耗。详见资源消耗说明。
AspectRatio	String	是	`16:9`	高光片段的画面宽高比。取值如下： `16:9`：横屏 `9:16`：竖屏 `1:1`：方形
SourceEndTime	Long	是	`300`	智剪范围在原视频中的结束时间，单位为秒。该时间之后的视频不参与剪辑。
SourceStartTime	Long	是	`0`	智剪范围在原视频中的开始时间，单位为秒。该时间之前的视频不参与剪辑。

返回参数

参数	类型	示例值	描述
Id	Long	`1`	创建成功的高光智剪任务 ID。

请求示例

POST https://livesaas.volcengineapi.com/?Action=CreateHighlightClipTask&Version=2023-08-01
{
    "Vid": "v0c251g7007ada6nr77og65s9o4hv2rg",
    "Scene": 1,
    "CoverImage": "https://p-boe-sign.bytedance.net/tos-boe-v-c1801c/o0Cqxxx",
    "Title": "剪辑任务名称",
    "HighlightClipConfig": {
        "DurationMin": 30,
        "DurationMax": 60,
        "Definition": "1080p",
        "AspectRatio": "16:9",
        "SourceEndTime": 300,
        "SourceStartTime": 0
    },
    "UserPrompt": "过滤视频中的重复表述、长时间沉默、卡顿口误、空镜头、闲聊内容，提取整场直播全部有效核心信息，剪辑成精简高光视频。"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateHighlightClipTask",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "Id": 1
    }
}

错误码

访问公共错误码和错误码获取详细信息。

最近更新时间：2026.10.12 16:45:07

这个页面对您有帮助吗？

有用

无用

企业直播

注意事项 #

请求说明 #

调试 #

请求参数 #

Query #

Body #

HighlightClipConfig #

返回参数 #

请求示例 #

返回示例 #

错误码 #