您可通过此接口对企业直播控制台的媒资库 > 视频库或直播暂存页面中的指定视频进行剪辑。
请求频率：单用户请求频率限制为 10 次/秒。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | MediaCut | 接口名称。当前 API 的名称为 MediaCut。 |
| Version | String | 是 | 2023-08-01 | 接口版本。当前 API 的版本为 2023-08-01。 |
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Vid | String | 是 | v0c251g7007acp7jhnvog65i97kr43jg | 视频 Vid。您可以通过 ListActivityMediaAPI 接口查询 Vid。 |
| StartTime | Integer | 否 | 6 | 视频剪辑的开始时间，即该时间之前的视频将被裁剪。单位为秒。 |
| EndTime | Integer | 否 | 26 | 视频剪辑的结束时间，即该时间之后的视频将被裁剪。单位为秒。 |
| MediaName | String | 否 | 剪辑文件_202406301230 | 剪辑生成的视频名称。名称默认为：剪辑文件 + "_" + 年月日 + 时分。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| CutTaskId | String | d070c7****41f7de8677b94eb | 剪辑任务 ID。返回该 ID，表示已成功将剪辑任务提交至云剪辑。剪辑任务完成后，将通过剪辑视频结果回调进行通知。 |
POST https://livesaas.volcengineapi.com/?Action=MediaCut&Version=2023-08-01 { "Vid": "v0c251g7007a8jhnvog65i97kr43jg", "StartTime": 6, "EndTime": 26, "MediaName": "剪辑文件_202406301230" }
{ "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "MediaCut", "Version": "2023-08-01", "Service": "livesaas", "Region": "cn-north-1", "SystemTime": 1717343704 }, "Result": { "CutTaskId": "d070c7****41f7de8677b94eb" } }