You need to enable JavaScript to run this app.
导航
SubmitDirectEditTaskSync - 提交同步剪辑任务
最近更新时间:2025.03.10 15:58:32首次发布时间:2024.08.30 16:44:13
我的收藏
有用
有用
无用
无用

调用 SubmitDirectEditTaskSync 提交同步视频剪辑任务,进行简单 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-下游服务错误