服务端 API 文档

视频剪辑

最近更新时间:2019-08-27 16:14:31

接口名称

ClipVideo

注意:

本接口已不再维护,新接口 EditMedia 为您提供更完备的功能,请尽快迁移。

功能说明

  • 将源视频文件按指定偏移时间进行掐头去尾剪切,新生成的视频文件(目标文件)将拥有新的 FileID。
  • 剪辑出来的文件分辨率及码率都和源文件接近,文件格式为 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"
}
目录