You need to enable JavaScript to run this app.
导航
视频截帧
最近更新时间:2024.07.01 11:07:18首次发布时间:2023.04.13 11:18:04

视频截帧功能(snapshot)可以从视频流中截取指定时刻的单帧画面,并按指定大小缩放成图片。本文介绍视频截帧相关参数说明和使用示例。

说明

使用视频截帧功能时,会产生视频截帧费用、请求费用和流量费用。详细计费介绍,请参见数据处理费用请求次数费用流量费用

注意事项

TOS 默认不保存视频截帧的图片。提供以下两种方式保存图片:

  • 手动下载图片,并保存至本地。
  • 使用图片处理持久化功能将截取的图片保存至存储桶,更多信息,请参见图片处理持久化

参数说明

参数

参数说明

取值说明

是否必须

t

指定在视频中截图时间点。

  • [0, 视频时长]
  • 仅支持整数
  • 单位:ms

w

指定截图宽度,如果指定为 0,则按原图的分辨率比例自动计算。

  • [0, 视频宽度]
  • 仅支持整数
  • 单位:像素(px)

h

指定截图高度,如果指定为 0,则按原图的分辨率比例自动计算。

说明

如果 w 和 h 都为 0,则输出原视频宽高。

  • [0, 视频高度]
  • 仅支持整数
  • 单位:像素(px)

m

指定截图模式。

  • 默认模式:不指定即为默认模式,将根据时间精确截图。
  • fast:截取该时间点之前的最近的一个关键帧。

    说明

    关键帧是在视频或动画中具有重要意义的特定帧,定义了关键的画面或状态。需要注意的是,由于各种因素,如编码、处理或传输过程中的影响,关键帧的时间显示可能并非完全精确。

f

指定输出图片格式。

  • jpg(默认值)
  • png

ar

指定是否根据视频信息自动旋转图片。

  • auto:在截图生成之后根据视频信息进行自动旋转。
  • w:在截图生成之后根据视频信息强制按照宽大于高的模式旋转。
  • h:在截图生成之后根据视频信息强制按照高大于宽的模式旋转。

示例

原视频示例:https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4