视频截图
更新时间：2025-05-30 09:46:41
截图功能支持从视频中提取高质量静态帧，可用于缩略图、封面图、预览帧及内容审核。CDNetworks平台支持多种输入视频格式，并能通过高级格式配置生成多种输出格式的图像。
支持格式
- 视频格式: MP4、FLV、M3U8、TS、MKV、MOV、WMV、AVI、VP8、VP9、RealVideo、Windows Media Video等
- 编码格式: H.265、H.264、H.263、MPEG等
- 截图格式: JPG、PNG、GIF（JPG/PNG支持CSS雪碧图）
使用方法
请在请求体中，按以下格式填写您的fops命令：
<op>/<Format>
/offset/<value>
/offsets/<value>
/interval/<value>
/vframeN/<value>
/t/<value>
/sprite/<value>
/mode/<value>
/w/<value>
/h/<value>
/autofill/<value>
/rotate/<value>
/isZip/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
参数说明
| 参数 | 必填 | 描述 |
|---|---|---|
op |
是 | 操作类型。截图功能需设置为vframe |
format |
是 | 输出的目标格式（如jpg、png、gif等） |
offset |
否 | 单帧截图，指定截取视频的时刻。（单位：秒，支持3位小数精度） |
offsets |
否 | 多帧截图，指定截取多张视频图片，按升序以冒号分隔 示例： 0:30:60:120截取0秒、30秒、60秒、120秒的帧 |
interval |
否 | 指定连续截图的时间间隔。（单位：秒） |
vframeN |
否 | 在固定的interval下指定截图张数，范围是1,2,3,4等 |
t |
否 | GIF输出时长，指定截取视频为GIF图片的时长（单位：秒，默认5秒） |
sprite |
否 | 生成CSS雪碧图，指定行列模式 如 4x5生成4行5列的合并图注：需与 interval配合使用 |
mode |
否 | 等比缩放模式（详见模式参数表） |
w |
否 | 截图宽度（单位：像素，范围1-1920） |
h |
否 | 截图高度（单位：像素，范围1-1080） |
autofill |
否 | 尺寸填充模式（需同时指定w和h时生效）：• 0（默认）- 强制拉伸（可能变形）• 1 - 等比缩放并填充黑边注：不可与 mode同时使用 |
rotate |
否 | 旋转角度：90、180、270或auto（自动旋转） |
isZip |
否 | 多帧截图打包为ZIP： • 0 - 不打包• 1 - 生成ZIP（文件名按序编号，如a_00001.jpg）注：输出文件名需以.zip结尾 |
saveas |
否 | 输出路径，需进行URL安全Base64编码：Urlsafe_Base64_Encode(bucket:savedfilename) |
模式参数表
| 模式参数 | 描述 |
|---|---|
/mode/1 |
等比缩放，居中裁剪至精确尺寸。举例：原图宽:高=60:30，限定截图后的宽=30、高=10，那么最终截图的宽:高=30:10，高度将会被裁剪掉5。 如果仅指定一维(宽/高)，则按该维等比缩放无需裁剪 |
/mode/2 |
等比缩放，不裁剪，限定高度/宽度≤某个值。举例：原图宽:高=60:30，限定截图后的宽≤30、高≤10，那么最终截图的宽:高=20:10。 若仅指定宽或高中其中一维值，另一维按比例调整. |
/mode/3 |
等比缩放，不裁剪，限定高度/宽度≥某个值。举例：原图宽:高=60:30，限定截图后的宽≥30、高≥10，那么最终截图的宽:高=30:15。 若仅指定宽或高中其中一维值，另一维按比例调整 |
示例
从test-mp4-encrypt存储空间的视频test.mp4中截取第5秒的帧，保存为JPG图像并命名为test.jpg：
伪代码
curl -v -X POST
–d "bucket=Urlsafe_Base64_Encode(test-mp4-encrypt)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(vframe/jpg/offset/5|saveas/Urlsafe_Base64_Encode(test-mp4-encrypt:test.jpg))&force=1&separate=1"
–H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
实际请求
curl -v -X POST
-d "bucket=dGVzdC1tcDQtZW5jcnlwdA==&key=dGVzdC5tcDQ=&fops=dmZyYW1lL2pwZy9vZmZzZXQvNXxzYXZlYXMvZEdWemRDMXRjRFF0Wlc1amNubHdkRHAwWlhOMExtcHdadz09&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
本篇文档内容对您是否有帮助？
有帮助
我要反馈