视频剪辑

最近更新时间:2019-01-30 15:54:48

接口名称

ClipVideo

功能说明

  1. 将源视频文件按指定偏移时间进行掐头去尾剪切,新生成的视频文件(目标文件)将拥有新的 FileID;
  2. 剪辑出来的文件分辨率和码率都和源文件接近,文件格式是 mp4。

事件通知

剪辑完成事件。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
fileId String 源文件的唯一标识 ID
newFileName String 目标文件名称
startTimeOffset Float 目标文件开始相对源文件的时间偏移,单位为秒,大于等于0表示从头部开始计算,小于0表示从尾部开始计算,不填默认0。
endTimeOffset Float 目标文件结束相对源文件的时间偏移,单位为秒,大于等于0表示从头部开始计算,小于0表示从尾部开始计算,不填表示到文件结尾。
COMMON_PARAMS 参见 公共参数

请求示例一:截取区间

期望生成的目标文件为源文件的第2秒到第10秒的视频内容,请求示例如下:

https://vod.api.qcloud.com/v2/index.php?Action=ClipVideo
&fileId=16092504232103571364
&newFileName=cutFileName
&startTimeOffset=2.0
&endTimeOffset=10.0
&COMMON_PARAMS

请求示例二:掐头去尾

期望生成的目标文件为源文件开始2秒到结束前5秒的内容,请求示例如下:

https://vod.api.qcloud.com/v2/index.php?Action=ClipVideo
&fileId=16092504232103571364
&newFileName=cutFileName
&startTimeOffset=2.0
&endTimeOffset=-5.0
&COMMON_PARAMS

请求示例三:截取头部

期望生成的目标文件为源文件从开始到结束前10秒的视频内容,请求示例如下:

https://vod.api.qcloud.com/v2/index.php?Action=ClipVideo
&fileId=16092504232103571364
&newFileName=cutFileName
&startTimeOffset=0
&endTimeOffset=-10.0
&COMMON_PARAMS

请求示例四:截取尾部

期望生成的目标文件为源文件开始2秒到结束的内容,请求示例如下:

https://vod.api.qcloud.com/v2/index.php?Action=ClipVideo
&fileId=16092504232103571364
&newFileName=cutFileName
&startTimeOffset=2.0
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功;其他值:失败
message String 错误信息
vodTaskId String 剪辑任务 Id

错误码说明

错误码 含义说明
4000 - 7000 参见 公共错误码
1000 无效参数
1001 用户信息错误
10009 文件状态异常

应答示例

{
    "code": 0,
    "message": "",
    "vodTaskId": "clipVideo-0a78cf44c4285026a4c"
}