视频截帧功能（snapshot）可以从视频流中截取指定时刻的单帧画面，并按指定大小缩放成图片。本文介绍视频截帧相关参数说明和使用示例。 ## 计费说明 * 使用视频截帧功能时，会产生视频截帧费用、请求费用和流量费用。详细计费介绍，请参见[数据处理费用](/docs/6349/913151)、[请求次数费用](/docs/6349/79462)和[流量费用](/docs/6349/79461)。 * 对低频存储、归档闪回存储类型的文件使用视频截帧功能时，会产生数据取回费用，按照视频截帧后返回的内容大小进行收费，计费详情，请参见[数据取回费用](/docs/6349/104494)。 ## 注意事项 * 视频截帧功能支持的视频格式请参考[媒体处理概述](https://www.volcengine.com/docs/6349/336154)相关使用限制。 * TOS 默认不保存视频截帧的图片。提供以下两种方式保存图片： * 手动下载图片，并保存至本地。 * 使用图片处理持久化功能将截取的图片保存至存储桶，更多信息，请参见[图片处理持久化](/docs/6349/762921)。 ## 参数说明 |**参数** |**参数说明** |**取值说明** |**是否必须** | |---|---|---|---| |t |指定在视频中截图时间点。 |* [0, 视频时长]|是 |\ | | |* 仅支持整数| |\ | | |* 单位：ms | | |w |指定截图宽度，如果指定为 0，则按原图的分辨率比例自动计算。 |* [0, 视频宽度]|否 |\ | | |* 仅支持整数| |\ | | |* 单位：像素（px） | | |h |指定截图高度，如果指定为 0，则按原图的分辨率比例自动计算。|* [0, 视频高度]|否 |\ | |:::tip|* 仅支持整数| |\ | |如果 w 和 h 都为 0，则输出原视频宽高。|* 单位：像素（px） | |\ | || | |\ | |:::| | | |m |指定截图模式。 |* 默认模式：不指定即为默认模式，将根据时间精确截图。|否 |\ | | |* fast：截取该时间点之前的最近的一个关键帧。| |\ | | | :::tip| |\ | | | 关键帧是在视频或动画中具有重要意义的特定帧，定义了关键的画面或状态。需要注意的是，由于各种因素，如编码、处理或传输过程中的影响，关键帧的时间显示可能并非完全精确。| |\ | | || |\ | | | :::| | |f |指定输出图片格式。 |* jpg（默认值）|否 |\ | | |* png | | |ar |指定是否根据视频信息自动旋转图片。 |* auto：在截图生成之后根据视频信息进行自动旋转。|否 |\ | | |* w：在截图生成之后根据视频信息强制按照宽大于高的模式旋转。| |\ | | |* h：在截图生成之后根据视频信息强制按照高大于宽的模式旋转。 | | ## 示例原视频示例：[https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4](https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4) * 使用默认模式截取 26000ms 处的帧，缩放宽度 400 px、高度 200 px，且图片输出格式为 jpg。示例 URL 如下： [https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg](https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg) 预期返回以下图片： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d8d88854d066fe87527bacff5a537528.JPEG =400x) * 使用 fast 模式截取 26000ms 处的帧，缩放宽度 400 px、高度 200 px，且图片输出格式为 jpg。示例 URL 如下： [https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg,m_fast](https://tos-tools.tos-cn-beijing.volces.com/misc/video.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg,m_fast) 预期返回以下图片： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9854fcfb43b9f9df629f00b78bbcf8e4.JPEG =400x)

对象存储