调用 GetHighlightClipTaskDetail 接口,查询指定高光智剪任务的配置、剪辑结果和导出记录。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | GetHighlightClipTaskDetail | 接口名称。当前 API 的名称为 GetHighlightClipTaskDetail。 |
| Version | String | 是 | 2023-08-01 | 接口版本。当前 API 的版本为 2023-08-01。 |
| Id | Long | 是 | 1 | 高光智剪任务 ID。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Vid | String | v0c251g7007ada6nr77og65s9o4hv2rg | 高光智剪任务关联的原视频 Vid。 |
| CoverImage | String | https://p-boe-sign.bytedance.net/tos-boe-v-c1801c/o0Cqxxx | 高光智剪任务的封面图片 URL。包含协议头。 |
| Title | String | Demo视频高光 | 高光智剪任务的名称。 |
| HighlightClipConfig | Object of HighlightClipConfig | - | 高光智剪的任务配置。 |
UserPrompt | String |
| 用于指导高光内容识别和剪辑的用户提示词。 说明 仅当 |
| CloudEditTaskList | Array of CloudEditTaskList | - | 该高光智剪任务关联的导出记录列表。 |
Status | Integer |
| 高光智剪任务状态。取值如下:
|
| CreateTime | Integer | 1787658478 | 高光智剪任务的创建时间,Unix 时间戳,单位为秒。 |
Scene | Integer |
| 高光智剪场景。取值如下:
|
| Id | Long | 1 | 高光智剪任务 ID。 |
| HighlightClipVideoList | Array of HighlightClipVideoList | - | 剪辑出的所有高光片段列表。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| DurationMin | Long | 30 | 最终剪辑的单个高光片段的最短时长,单位为秒。 |
| DurationMax | Long | 60 | 最终剪辑的单个高光片段的最长时长,单位为秒。 |
| Definition | String | 1080p | 高光片段的清晰度。支持 1080p 和 720p。 |
AspectRatio | String |
| 高光片段的画面宽高比。取值如下:
|
| SourceEndTime | Long | 300 | 智剪范围在原视频中的结束时间,单位为秒。该时间之后的视频不参与剪辑。 |
| SourceStartTime | Long | 0 | 智剪范围在原视频中的开始时间,单位为秒。该时间之前的视频不参与剪辑。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
Vid | String |
| 导出的高光智剪视频的 Vid。 说明 该参数仅当高光智剪任务完成且导出高光智剪视频后有值。 |
| Name | String | Demo视频高光导出 | 导出视频的名称。 |
Status | Integer |
| 视频导出状态。取值如下:
|
| SourceVideoList | Array of SourceVideoList | - | 导出的视频所包含的原始高光片段列表。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| VideoDesc | String | 展示精纺羊毛西装面料特性 | AI 智剪的高光片段的内容描述。 |
| StartTime | Long | 2000 | 高光片段在原视频中的开始时间,单位为毫秒。 |
| EndTime | Long | 11000 | 高光片段在原视频中的结束时间,单位为毫秒。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| VideoDesc | String | 展示精纺羊毛西装面料特性 | 用户导出的视频中包含的高光片段的内容描述。 |
| StartTime | Long | 2000 | 高光片段在原视频中的开始时间,单位为毫秒。 |
| EndTime | Long | 11000 | 高光片段在原视频中的结束时间,单位为毫秒。 |
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 } ] } }