视频帧缩略图(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> 指定顺时针旋转的度数,可取值为90180270auto,默认为不旋转。

请求

请求语法

可以通过上传预转(persistentOps)或者触发持久化处理(pfop)的方式来调用

示例

  1. 取视频第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"
    }

触发持久化处理(pfop):

    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)的异步处理方式而且支持同步处理方式。


如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询