提交媒体剪辑任务更新时间：2021-04-25 11:01:25

提交媒体剪辑任务

基本信息

Path： /api/v2/vod

接口描述： 提交媒体剪辑任务，开始异步处理，结果需等待事件回调。

结果请监听回调事件：媒体剪辑完成

场景描述：

可针对回放过程中，出现的异常情况，可调用此接口进行剪辑处理，灵活生成视频提供观看

请求参数

Query

参数名称 类型 是否必须 示例 备注
action string 是 SubmitVideoEditTasks 固定参数，SubmitVideoEditTasks
app_id string 是 f4efa787 app_id
vod_id string 是 4377e1d5 原点播ID
cut_sections json 是 参考下表cut_sections参数说明 裁剪操作具体信息
point_sections json 否  参考下表point_sections参数说明 打点操作具体信息
ts_cut_type int 否 '0' TS裁剪类型。在遇到ts视频粗颗粒裁剪的情况下，对裁剪区间边界的ts如何处理。

‘0’表示去除（默认），‘1’表示保留。
edit_type string 否 '0' '0'（粗剪，默认，非必填字段），'1'（精剪）

cut_sections 参数

参数名称 类型 含义
start int 裁掉片段的相对开始时间, 秒/单位
end int 裁掉片段的相对结束时间, 秒/单位 
[
    {
        "start":0, #裁掉片段的相对开始时间
        "end":40 #裁掉片段的相对结束时间
    },
    {
        "start":580,
        "end":600
    }
]

point_sections 参数

参数名称 类型 含义
timePoint int 打点相对时间点 , 秒/单位
msg string 打点文字信息 
[
    {
        "timePoint": 12, #打点相对时间点
        "msg": "abc" #打点文字信息
    },
    {
        "timePoint": 52, #打点相对时间点
        "msg": “xxx” #打点文字信息
    }
]

出参

参数 类型 是否必选 含义
vod_id string 是 点播ID
task_id string 是 剪辑任务ID

返回数据

{
  "msg": "task pending",
  "code": 200,
  "request_id": "B36A562C-BBE7-4B16-9F4A-C7A03AC9D6E2",
  "data": {
    "vod_id": "44a0b83c",
    "task_id": "77475a45-60ec-4937-ba64-ce12e9255853"
  }
}