智能多媒体服务

  • 智能多媒体服务 > API 文档 > 音视频处理 >视频单帧缩略图(vframe)

    视频单帧缩略图(vframe)

    最近更新时间: 2024-06-28 17:22:31

    简介

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

    接口规格

    vframe/<Format>
          /offset/<Second>
          /w/<Width>
          /h/<Height>
          /rotate/<Degree>
    
    参数名称 必填 说明
    <Format> 输出的目标截图格式,支持jpgpng等。
    /offset/<Second> 指定截取视频的时刻,单位:秒,精确到毫秒。
    /w/<Width> 缩略图宽度,单位:像素(px)
    /h/<Height> 缩略图高度,单位:像素(px)
    /rotate/<Degree> 指定顺时针旋转的度数,可取值为90180270auto,默认为不旋转。

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

    操作方式

    • API方式
      1)可以通过 同步处理 的方式来调用。

      • 注意:建议视频文件不能太大,举例用户设置该接口的超时时间为10s,那么同步处理的视频文件最好不超过450MB ,否则可能会超时导致处理失败。

      2)可以通过 持久化处理 的方式来调用:

      • 资源上传时自动触发:可以在上传时指定persistentOps参数
      • 对已有资源手动手动触发:调用pfop命令
    • 控制台方式:您可以使用智能多媒体平台,可视化创建任务,使用详情请参考 任务

    示例

    取视频第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
    

    以 Python Sdk 为例,具体可以看下音视频转码的示例。需要在音视频转码的示例的基础修改数据处理命令 fops ,将其修改为:

    fops = vframe%2fjpg%2foffset%2f7%2fw%2f480%2fh%2f360
    

    注意:其他语言 Sdk 可在官方 Sdks 下载,可以通过查看 Sdk 使用指南中资源上传时自动触发对已有资源手动触发使用。

    计费说明

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

    以上内容是否对您有帮助?
  • Qvm free helper
    Close