视频截帧
更新时间：2026-06-17
基本概念
百度智能云 BOS 提供视频截帧接口，支持通过设置 URL 参数的方法对存储在 BOS 的视频文件进行截取。
注意事项
- 使用视频截帧，2022 年 4 月 1 日正式商业化，计费详情参见 BOS价格说明 -> 数据处理 -> 视频截帧。
视频截帧命令
视频文件远大于图片文件，处理时间也较长，通常在秒级。
- 操作分类：
video - 操作名称：
snapshot
BOS 视频处理接口定义如下：
| 参数名称 | 缩写 | 类型 | 位置 | 取值 | 命令描述 | 是否必选 |
|---|---|---|---|---|---|---|
time |
t |
int | Query | 视频时长之内 | 截帧的时间，单位为毫秒 | 是 |
format |
f |
string | Query | jpg、png、bmp、gif、tif |
输出的图片格式 | 否 |
width |
w |
int | Query | [0, 4096] |
指定截图宽度 | 否 |
height |
h |
int | Query | [0, 4096] |
指定截图高度 | 否 |
auto-rotate |
ar |
string | Query | 90、180、270、auto |
指定旋转角度；若设置为 auto，则根据视频文件信息自动旋转 |
否 |
mode |
m |
string | Query | fast |
截图类型；若设置为 fast，则截取 time 时间点最近的关键帧 |
否 |
视频截帧下载
截图下载示例：
请求成功后，BOS 返回截帧图片内容。默认输出格式为 JPG，响应类型为 image/jpeg。如果源 Object 为私有 Object，需要在 URL 查询参数中增加 authorization 签名。## 视频截帧转存 BOS
转存 BOS 示例：
其中，system/save,o_dGVzdC5qcGVn 表示将截帧结果转存到 BOS，dGVzdC5qcGVn 为转存结果 Object 名称的 Base64 编码。请求成功后，BOS 返回截帧图片内容，并将同一图片保存到目标 Object。## 请求示例
- 使用默认模式截取视频 7s 处的内容，默认情况下输出格式为 JPG，输出宽高为原视频宽高。
处理的 URL 为：
Text
1<原视频 URL>?x-bce-process=video/snapshot,t_7000- 使用关键帧模式截取视频 7s 处的内容，输出为 PNG 格式的图片，宽度为 800，高度为 600，且旋转角度为 90 度。
处理的 URL 为：
Text
1<原视频 URL>?x-bce-process=video/snapshot,t_7000,f_png,w_800,h_600,ar_90,m_fast规则和限制
- 目前仅支持北京、苏州、广州、保定地域使用。
- 目前仅支持在页面添加 URL 参数的方式进行截取。
-
使用私有 Object 的签名 URL 时，
x-bce-process需要作为查询参数参与签名；实际发起 HTTP 请求时，请按 URL 编码规则对查询参数进行编码。- 支持截帧的最大视频大小为 10G。支持私有 Object 截取，需在 URL 的参数中增加authorization签名，签名生成可使用 IAM 工具，链接如下：
评价此篇文章