视频帧缩略图(vframe)
描述
从视频流中截取指定时刻的单帧画面并按指定大小缩放成图片。 注:不支持m3u8截帧。
接口规格(vframeSpec)
vframe/<Format>
/offset/<Second>
/w/<Width>
/h/<Height>
/rotate/<Degree>
参数名称 | 必填 | 说明 |
<Format> |
是 | 输出的目标截图格式,支持jpg、png等。 |
/offset/<Second> |
是 | 指定截取视频的时刻,单位:秒,精确到毫秒。 |
/w/<Width> |
缩略图宽度,单位:像素(px),取值范围为1-3840。 | |
/h/<Height> |
缩略图高度,单位:像素(px),取值范围为1-2160。 | |
/rotate/<Degree> |
指定顺时针旋转的度数,可取值为90 、180 、270 、auto ,默认为不旋转。 |
请求
请求语法
可以通过上传预转(persistentOps)或者触发持久化处理(pfop)的方式来调用
示例
- 取视频第7秒的截图,图片格式为jpg,宽度为480px,高度为360px:
上传预转(persistentOps)上传的token
中指定persistentOps
:
{
"scope": "qiniu-ts-demo:thinking-in-go.mp4",
"deadline": 1390528576,
"persistentOps": "vframe/jpg/offset/7/w/480/h/360",
"persistentNotifyUrl": "http://fake.com/qiniu/notify"
}
POST /pfop/ HTTP/1.1
Host: api.qiniu.com
Content-Type: application/x-www-form-urlencoded
Authorization: QBox <AccessToken>
bucket=qiniu-ts-demo
&key=thinking-in-go.mp4
&fops=vframe%2fjpg%2foffset%2f7%2fw%2f480%2fh%2f360
附注
视频帧缩略图(vframe)不仅支持触发持久化处理(pfop)的异步处理方式而且支持同步处理方式。
如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询