通過視頻截幀功能，用戶可以在GetObject請求中攜帶視頻截幀處理參數對視頻文件進行處理，服務默認會保存視頻截幀的圖片，圖片會保存在視頻所在 bucket 的 snapshot 目錄下面。

本文介紹視頻截幀操作涉及的參數說明及使用示例。

適用區域

本功能目前僅部分資源池支持，具體可參考：資源池與區域節點。

如需使用，可聯系客戶經理或提交工單申請。

注意事項

僅支持對視頻編碼格式為H264和H265的視頻文件進行視頻截幀。

媒體存儲默認會保存視頻截幀的圖片，圖片會保存在視頻所在 bucket 的 snapshot 目錄下面。

操作分類：video

操作名稱：snapshot

參數	描述	取值范圍
t	指定截圖時間。	[0,視頻時長] 單位：ms
w	指定截圖寬度，如果指定為0，則自動計算。	[0,視頻寬度] 單位：像素（px）
h	指定截圖高度，如果指定為0，則自動計算; 如果w和h都為0，則輸出為原視頻寬高。	[0,視頻高度] 單位：像素（px）
m	指定截圖模式，不指定則為默認模式，根據時間精確截圖。如果指定為fast，則截取該時間點之前的最近的一個關鍵幀。	枚舉值：fast
f	指定輸出圖片的格式。	枚舉值：jpg、png

使用fast模式截取視頻7s處的內容，輸出為JPG格式的圖片，寬度為800，高度為600。

處理后的URL為：<原視頻URL>?x-amz-process=video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast

使用精確時間模式截取視頻50s處的內容，輸出為JPG格式的圖片，寬度為800，高度為600。

處理后的URL為：<原視頻URL>?x-amz-process=video/snapshot,t_50000,f_jpg,w_800,h_600