You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/用户指南/数据处理/媒体处理/视频截帧
视频截帧
最近更新时间：2025.01.02 19:04:12首次发布时间：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