简介

视频单帧缩略图接口(vframe)用于从视频流中截取指定时刻的单帧画面并按指定大小缩放成图片。

参数说明

vframe/<Format>
      /offset/<Second>
      /w/<Width>
      /h/<Height>
      /rotate/<Degree>

注意：
1、当指定w而不指定h时，缩略图的高度将等比缩放；当指定h而不指定w时，缩略图的宽度将等比缩放。
2、w 与 h 中，长边取值范围 [20,3840]，短边取值范围 [20,2160]。

操作方式

您可以通过以下几种方式来创建任务：

方式一：视频访问链接?参数

• 即通过 同步处理 的方式，即在访问文件URL时，添加数据处理指令，以直接获取处理后的结果。

方式二：使用任务触发器

• 对符合规则策略的上传文件自动触发：在具体空间下，选择任务与工作流，进入任务触发器页面，点击新建 任务触发器；创建完成后，需要开启 上传触发开关，然后通过左侧文件管理或 API/SDK 上传文件到触发器指定的输入路径；将对符合规则策略的上传文件自动触发多媒体处理，并将结果文件保存到目标路径。

  

方式三：使用对象存储控制台

• 上传文件手动触发：在具体空间下， 上传文件 时，指定工作流模板 。

  

• 指定文件手动触发：有两种指定单个文件创建任务的入口

  • 第一个入口：在具体空间下，在文件列表中指定文件，在操作栏【更多】中点击【创建多媒体任务】。

    

    注意：仅对音视频/gif动图/webp动图文件提供该操作。
    

  • 第二个入口：在具体空间下，选择任务与工作流，进入任务管理页面，点击【新建任务】。

    

方式四：使用API

• 资源上传时手动触发：可以在构造上传凭证时在上传策略中，设置相关字段，在资源文件上传时触发处理。
• 对已有资源手动触发：可以在调用 持久化数据处理(pfop) 时，设置相关字段，对已存在空间中的资源文件发起处理。

方式五：使用SDK

• 查看各语言 SDK 使用指南中 持久化数据处理 章节，可在七牛官方SDK 进行下载。

操作示例

取视频第7秒的截图，图片格式为jpg，宽度为480px，高度为360px：

资源上传时手动触发：上传的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: Qiniu <AccessToken>  

bucket=qiniu-ts-demo
&key=thinking-in-go.mp4
&fops=vframe%2fjpg%2foffset%2f7%2fw%2f480%2fh%2f360

计费说明

视频单帧缩略图，以 截取图片总张数 来计量计费。服务价格=视频截图价格，定价参考 智能多媒体服务定价 。