文档中心

对象存储

请输入

媒体处理

视频截帧

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

计费说明

注意事项

参数说明

参数	参数说明	取值说明	是否必须
t	指定在视频中截图时间点。	[0, 视频时长] 仅支持整数单位：ms	是
w	指定截图宽度，如果指定为 0，则按原图的分辨率比例自动计算。	[0, 视频宽度] 仅支持整数单位：像素（px）	否
h	指定截图高度，如果指定为 0，则按原图的分辨率比例自动计算。说明如果 w 和 h 都为 0，则输出原视频宽高。	[0, 视频高度] 仅支持整数单位：像素（px）	否
m	指定截图模式。	默认模式：不指定即为默认模式，将根据时间精确截图。 fast：截取该时间点之前的最近的一个关键帧。说明关键帧是在视频或动画中具有重要意义的特定帧，定义了关键的画面或状态。需要注意的是，由于各种因素，如编码、处理或传输过程中的影响，关键帧的时间显示可能并非完全精确。	否
f	指定输出图片格式。	jpg（默认值） png	否
ar	指定是否根据视频信息自动旋转图片。	auto：在截图生成之后根据视频信息进行自动旋转。 w：在截图生成之后根据视频信息强制按照宽大于高的模式旋转。 h：在截图生成之后根据视频信息强制按照高大于宽的模式旋转。	否

示例

最近更新时间：2026.02.03 17:53:49

这个页面对您有帮助吗？

有用

无用