调用 ExportHighlightClip 接口,将指定的高光片段合成为一个视频并导出。
注意事项
- 请求频率:单用户请求频率限制为 10 次/秒。
- 前提条件:
- 确保您拥有火山引擎主账号,或具备媒资库 > 视频管理 > 视频库或直播暂存 > 可编辑权限的子账号。有关如何添加子账号,详见权限管理。
- 使用子账号调用接口时,仅支持导出该子账号可见的视频所关联的高光智剪任务中的高光片段。有关如何配置子账号的可见范围,详见权限管理中可见范围相关内容。
- 该接口仅支持提交合并与导出高光片段任务。任务提交后,您可通过 AI 高光智剪片段导出结果回调获取导出高光片段的结果。导出的视频将存放至视频库。
请求说明
- 请求方式:POST
- 请求地址:https://livesaas.volcengineapi.com/?Action=ExportHighlightClip&Version=2023-08-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
去调试请求参数
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
Query
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|
| Action | String | 是 | ExportHighlightClip | 接口名称。当前 API 的名称为 ExportHighlightClip。 |
| Version | String | 是 | 2023-08-01 | 接口版本。当前 API 的版本为 2023-08-01。 |
Body
CloudEditSourceVideoList
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|
| VideoDesc | String | 是 | 展示精纺羊毛西装面料特性 | 导出的视频中包含的高光片段的内容描述。 |
| StartTime | Long | 是 | 2000 | 高光片段在原视频中的开始时间,单位为毫秒。 |
| EndTime | Long | 是 | 11000 | 高光片段在原视频中的结束时间,单位为毫秒。 |
返回参数
| 参数 | 类型 | 示例值 | 描述 |
|---|
| Status | Boolean | true | 是否成功提交导出任务。成功返回 true。您可通过 AI 高光智剪片段导出结果回调获取导出高光片段的结果。 |
请求示例
POST https://livesaas.volcengineapi.com/?Action=ExportHighlightClip&Version=2023-08-01
{
"CloudEditSourceVideoList": [
{
"VideoDesc": "展示精纺羊毛西装面料特性",
"StartTime": 2000,
"EndTime": 11000
}
],
"Vid": "v0c251g7007ada6nr77og65s9o4hv2rg",
"Id": 1
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420****100232280022D31",
"Action": "ExportHighlightClip",
"Version": "2023-08-01",
"Service": "livesaas",
"Region": "cn-north-1",
"SystemTime": 1697446406
},
"Result": {
"Status": true
}
}
错误码
访问公共错误码和错误码获取详细信息。