视频剪辑合并
更新时间:2018-12-20
接口描述
该接口用于获取视频剪辑合并。
注:
1.裁剪视频
单次裁剪不能超过5个片段,片段之间时间从小到大,最大不能超过视频的时长。
2.notifyUrl回调地址使用方法和spark系统的上传保持一致,详细请参考flash上传第四步回调。
特别的:当剪辑合并失败时也会收到通知,附加参数为“videoid=XXX&status=FAIL&duration=0”。
请求地址
https://spark.bokecc.com/api/video/montage
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
editParam |
String |
是 |
编辑视频参数(该参数为json字符串)。 |
editParam说明
名称 |
类型 |
必填 |
描述 |
userId |
String |
是 |
用户ID。 |
editType |
Integer |
是 |
视频编辑的类型(1:裁剪,2:合并)。 |
dstName |
String |
否 |
新视频名称(如不填,系统分配一个默认名称)。 |
categoryId |
String |
否 |
要上传到的分类ID(如不填,使用用户默认分类)。 |
notifyUrl |
String |
否 |
视频编辑完成后接收通知的地址。 |
editVideos |
Array |
是 |
编辑视频信息。 |
editVideos说明
名称 |
类型 |
必填 |
描述 |
srcVid |
String |
是 |
需要裁剪或合并的原始视频ID。 |
srcName |
String |
否 |
需要裁剪或合并的原始视频名称。 |
srcDuration |
Integer |
否 |
需要裁剪或合并的原始视频播放时长(单位:秒)。 |
sections |
Array |
否 |
需要裁剪保留的起始时间列表(editType为1时必选)。 |
sectio5ns说明
名称 |
类型 |
必填 |
描述 |
start |
Integer |
否 |
裁剪片段开始时间(单位:秒,editType为1时必选,不能大于end值)。 |
end |
Integer |
否 |
裁剪片段结束时间(单位:秒,editType为1时必选,不能小于start值且和start间隔需要大于5秒)。 |
请求示例
https://spark.bokecc.com/api/video/montage?editParam=%7B%22dstName%22%3A%221363713162AE0848-xxx.flv%22%2C%22editVideos%22%3A%5B%7B%22srcName%22%3A%22abc.mp4%22%2C%22srcDuration%22%3A%22240%22%2C%22sections%22%3A%5B%7B%22start%22%3A%225%22%2C%22end%22%3A%2225%22%7D%2C%7B%22start%22%3A%2255%22%2C%22end%22%3A%2275%22%7D%2C%7B%22start%22%3A%2280%22%2C%22end%22%3A%22120%22%7D%5D%2C%22srcVid%22%3A%2263FFAC00765E9F349C33DC5901307xxx%22%7D%5D%2C%22editType%22%3A%222%22%2C%22notifyUrl%22%3A%22http%3A%2F%2Fa.bikecc.com%2Fcallback%22%2C%22userId%22%3A%221725A8A9604EAxxx%22%2C%22categoryId%22%3A%221%22%7D&time=1671169652708&hash=29932491E6973137329646AB0A143D9A
返回数据
名称 |
类型 |
说明 |
videoid |
String |
视频ID。 |
返回示例
{
"result": "OK",
"videoid": "C62BF4FCC87E86F79C33DC5901307461"
}