智能多媒体服务

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

    视频单帧缩略图（vframe）

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

    简介

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

    接口规格

    vframe/<Format>
      /offset/<Second>
      /w/<Width>
      /h/<Height>
      /rotate/<Degree>
    参数名称 必填 说明
    <Format> 是 输出的目标截图格式，支持jpg、png等。
    /offset/<Second> 是 指定截取视频的时刻，单位：秒，精确到毫秒。
    /w/<Width> 否 缩略图宽度，单位：像素（px）
    /h/<Height> 否 缩略图高度，单位：像素（px）
    /rotate/<Degree> 否 指定顺时针旋转的度数，可取值为90、180、270、auto，默认为不旋转。

    注意：
    1、当指定w而不指定h时，缩略图的高度将等比缩放；当指定h而不指定w时，缩略图的宽度将等比缩放。
    2、w 与 h 中，长边取值范围 [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