提交同步视频剪辑任务,进行简单 HLS 剪辑。
调用该接口对 HLS 视频进行按时间段裁剪,生成一个新的 HLS 视频。剪辑精度最小为一个 TS 切片,无法实现秒级或更为精确的剪辑。剪辑完成后,系统不重复存储 TS 文件,会生成一个新的 M3U8 文件,对应一个新的 Vid。您可以选择是否将剪辑生成的 M3U8 文件与其关联的 TS 分片绑定起来。默认不绑定,即删除了剪辑生成的 M3U8 文件后,其关联的 TS 分片不会被删除。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SubmitDirectEditTaskSync | 接口名称。当前 API 的名称为 SubmitDirectEditTaskSync 。 |
Version | String | 是 | 2018-01-01 | 接口版本。当前 API 的版本为 2018-01-01 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Uploader | String | 是 | edit_tob | 任务产物的上传空间。视频剪辑任务完成后输出的产物会被上传至此点播空间。 |
Application | String | 是 | SimpleCut | 剪辑任务类型。当前仅支持设为 SimpleCut 。 |
EditParam | Object | 是 | - | 详见简单 HLS 剪辑参数。 |
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | Integer | 0 | 任务状态码。为 0 表示任务执行成功。 |
Output | String | - | 详见简单 HLS 剪辑结果。 |
ReqId | String | 3b5fece1a47******443a6aeea5abc | 异步剪辑任务 ID。 |
POST https://vod.volcengineapi.com?Action=SubmitDirectEditTaskSync&Version=2018-01-01 { "Application": "SimpleCut", "Uploader":"edit_tob", "EditParam": { "Source": "", "Upload": { "Source": "vid://v02b6d970000********", "SpaceName": "edit_tob", "StorageBind": false }, "CutList": [ { "StartTime": 9, "EndTime": 78 }, { "StartTime": 157, "EndTime": 370 } ] } }
{ "ResponseMetadata": { "RequestId": "20220228******09170404E144", "Action": "SubmitDirectEditTaskSync", "Version": "2018-01-01", "Service": "vod", "Region": "cn-north-1" }, "Result": { "Code": 0, "Output": "{\"Bitrate\":null,\"Codec\":\"h264\",\"Duration\":299.91,\"Height\":810,\"Md5\":\"d6a6****87\",\"Resolution\":\"1080P\",\"Size\":6144,\"Uri\":\"tos***7/9ecd6b9**33/mai**c88c*.m3u8\",\"Vid\":\"v0cd0**56oh0\",\"Width\":1440}", "ReqId": "3b5fece1a47******443a6aeea5abc" } }
下表列举了本接口特有的错误码。如需了解更多错误码,详见视频点播公共错误码。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
500 | 1000 | - | 内部错误 |
500 | 1001 | - | 数据库写入错误 |
400 | 1010 | - | 参数错误 |
500 | 1014 | - | 下游服务错误 |