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

企业直播

复制全文
下载 pdf
AI 高光智剪
GetHighlightClipTaskDetail - 查询高光智剪任务详情
复制全文
下载 pdf
GetHighlightClipTaskDetail - 查询高光智剪任务详情

调用 GetHighlightClipTaskDetail 接口,查询指定高光智剪任务的配置、剪辑结果和导出记录。

注意事项

  • 请求频率:单用户请求频率限制为 10 次/秒。
  • 使用子账号调用接口时,仅支持查询该子账号可见的视频所关联的高光智剪任务详情。
  • 前提条件:确保您拥有火山引擎主账号,或具备媒资库 > 视频管理 > 视频库或直播暂存 > 仅查看或可编辑权限的子账号。有关如何添加子账号,详见权限管理。

请求说明

  • 请求方式:GET
  • 请求地址:https://livesaas.volcengineapi.com/?Action=GetHighlightClipTaskDetail&Version=2023-08-01

调试

请求参数

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

Query

参数类型是否必选示例值描述
ActionString是GetHighlightClipTaskDetail接口名称。当前 API 的名称为 GetHighlightClipTaskDetail。
VersionString是2023-08-01接口版本。当前 API 的版本为 2023-08-01。
IdLong是1高光智剪任务 ID。

返回参数

参数类型示例值描述
VidStringv0c251g7007ada6nr77og65s9o4hv2rg高光智剪任务关联的原视频 Vid。
CoverImageStringhttps://p-boe-sign.bytedance.net/tos-boe-v-c1801c/o0Cqxxx高光智剪任务的封面图片 URL。包含协议头。
TitleStringDemo视频高光高光智剪任务的名称。
HighlightClipConfigObject of HighlightClipConfig-高光智剪的任务配置。

UserPrompt

String

过滤视频中的重复表述、长时间沉默、卡顿口误、空镜头和闲聊内容,提取核心信息与精彩片段

用于指导高光内容识别和剪辑的用户提示词。

说明

仅当 Scene 取值为 100 时,该参数有值。

CloudEditTaskListArray of CloudEditTaskList-该高光智剪任务关联的导出记录列表。

Status

Integer

1

高光智剪任务状态。取值如下:

  • 1:进行中
  • 2:剪辑成功
  • 3:剪辑失败
CreateTimeInteger1787658478高光智剪任务的创建时间,Unix 时间戳,单位为秒。

Scene

Integer

100

高光智剪场景。取值如下:

  • 1:爆款商品讲解,智能截取商品卖点片段
  • 2:核心知识汇总,智能汇总关键内容
  • 3:金融分析复盘,提炼行情走势与观点
  • 100:自定义,根据您输入的提示词剪辑视频
IdLong1高光智剪任务 ID。
HighlightClipVideoListArray of HighlightClipVideoList-剪辑出的所有高光片段列表。

HighlightClipConfig

参数类型示例值描述
DurationMinLong30最终剪辑的单个高光片段的最短时长,单位为秒。
DurationMaxLong60最终剪辑的单个高光片段的最长时长,单位为秒。
DefinitionString1080p高光片段的清晰度。支持 1080p 和 720p。

AspectRatio

String

16:9

高光片段的画面宽高比。取值如下:

  • 16:9:横屏
  • 9:16:竖屏
  • 1:1:方形
SourceEndTimeLong300智剪范围在原视频中的结束时间,单位为秒。该时间之后的视频不参与剪辑。
SourceStartTimeLong0智剪范围在原视频中的开始时间,单位为秒。该时间之前的视频不参与剪辑。

CloudEditTaskList

参数类型示例值描述

Vid

String

v0c251g7007ada6nr77og65xxxx

导出的高光智剪视频的 Vid。

说明

该参数仅当高光智剪任务完成且导出高光智剪视频后有值。

NameStringDemo视频高光导出导出视频的名称。

Status

Integer

1

视频导出状态。取值如下:

  • 0:进行中
  • 1:成功
  • 2:失败
SourceVideoListArray of SourceVideoList-导出的视频所包含的原始高光片段列表。

HighlightClipVideoList

参数类型示例值描述
VideoDescString展示精纺羊毛西装面料特性AI 智剪的高光片段的内容描述。
StartTimeLong2000高光片段在原视频中的开始时间,单位为毫秒。
EndTimeLong11000高光片段在原视频中的结束时间,单位为毫秒。

SourceVideoList

参数类型示例值描述
VideoDescString展示精纺羊毛西装面料特性用户导出的视频中包含的高光片段的内容描述。
StartTimeLong2000高光片段在原视频中的开始时间,单位为毫秒。
EndTimeLong11000高光片段在原视频中的结束时间,单位为毫秒。

请求示例

GET https://livesaas.volcengineapi.com/?Action=GetHighlightClipTaskDetail&Version=2023-08-01&Id=1

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "GetHighlightClipTaskDetail",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1"
    },
    "Result": {
        "Vid": "v0c251g7007ada6nr77og65s9o4hv2rg",
        "CoverImage": "https://p-boe-sign.bytedance.net/tos-boe-v-c1801c/o0Cqxxx",
        "Title": "Demo视频高光",
        "HighlightClipConfig": {
            "DurationMin": 30,
            "DurationMax": 60,
            "Definition": "1080p",
            "AspectRatio": "16:9",
            "SourceEndTime": 300,
            "SourceStartTime": 0
        },
        "UserPrompt": "过滤视频中的重复表述、长时间沉默、卡顿口误、空镜头和闲聊内容,提取核心信息与精彩片段",
        "CloudEditTaskList": [
            {
                "Vid": "v0c251g7007ada6nr77og65xxxx",
                "Name": "Demo视频高光导出",
                "Status": 1,
                "SourceVideoList": [
                    {
                        "VideoDesc": "展示精纺羊毛西装面料特性",
                        "StartTime": 2000,
                        "EndTime": 11000
                    }
                ]
            }
        ],
        "Status": 1,
        "CreateTime": 1787658478,
        "Scene": 100,
        "Id": 1,
        "HighlightClipVideoList": [
            {
                "VideoDesc": "展示精纺羊毛西装面料特性",
                "StartTime": 2000,
                "EndTime": 11000
            }
        ]
    }
}

错误码

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

最近更新时间:2026.10.10 11:17:09
这个页面对您有帮助吗?
有用
有用
无用
无用