You need to enable JavaScript to run this app.
导航
提交同步剪辑任务
最近更新时间:2024.09.02 10:46:48首次发布时间:2024.08.30 16:44:13

提交同步视频剪辑任务,进行简单 HLS 剪辑。

使用说明

调用该接口对 HLS 视频进行按时间段裁剪,生成一个新的 HLS 视频。剪辑精度最小为一个 TS 切片,无法实现秒级或更为精确的剪辑。剪辑完成后,系统不重复存储 TS 文件,会生成一个新的 M3U8 文件,对应一个新的 Vid。您可以选择是否将剪辑生成的 M3U8 文件与其关联的 TS 分片绑定起来。默认不绑定,即删除了剪辑生成的 M3U8 文件后,其关联的 TS 分片不会被删除。

注意事项

  • 计费说明:视频剪辑计费价格请参见按量计费
  • 如需获取剪辑任务产物的播放地址,请在提交剪辑任务前,请完成以下操作:

请求说明

  • 请求方式:POST
  • 请求地址:https://vod.volcengineapi.com?Action=SubmitDirectEditTaskSync&Version=2018-01-01

调试

请求参数

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

Query

参数
类型
是否必选
示例值
描述
Action
String
SubmitDirectEditTaskSync
接口名称。当前 API 的名称为 SubmitDirectEditTaskSync
Version
String
2018-01-01
接口版本。当前 API 的版本为 2018-01-01

Body

参数
类型
是否必选
示例值
描述
Uploader
String
edit_tob
任务产物的上传空间。视频剪辑任务完成后输出的产物会被上传至此点播空间。
Application
String
SimpleCut
剪辑任务类型。当前仅支持设为 SimpleCut
EditParam
Object
-

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数

参数
类型
示例值
描述
Code
Integer
0
任务状态码。为 0 表示任务执行成功。
Output
String
-
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"
    }
}

错误码

下表列举了本接口特有的错误码。如需了解更多错误码,详见视频点播公共错误码

状态码错误码错误信息说明
5001000-内部错误
5001001-数据库写入错误
4001010-参数错误
5001014-下游服务错误