视频和动图截帧
frame 用于从视频或动图中取出一帧,常用于生成封面、缩略图和预览图。取出的画面可以继续叠加缩放、裁剪、水印、格式转换等全部图片参数。
参数说明
| 参数 | 适用源 | 含义 | 取值 |
|---|---|---|---|
frame | 视频 | 时间点,单位毫秒 | 0 及以上的整数 |
frame | 动图 | 帧序号,从 1 开始 | 1 及以上的整数 |
frame=auto | 视频 | 自动选封面帧 | auto |
视频
frame=0:第一帧frame=5000:第 5 秒处的画面frame=60000:第 1 分钟处的画面
HDR 视频(含杜比视界)截出的图片默认保留 HDR,详见 HDR 图片和视频。
动图
适用于 GIF、动态 WebP、APNG、动态 AVIF。
frame=1:第一帧frame=n:第 n 帧
指定的帧序号超出实际帧数时,返回最后一帧。
自动选封面帧
frame=auto 会在视频中自动挑选一帧适合做封面的画面:避开黑场、白闪和纯色画面,优先选择清晰、色彩丰富、构图美观的一帧。
- 选中的时间点通过响应头
x-coreix-frame-time返回,单位毫秒。 - 选帧失败时返回第一帧。
需要截取一段而不是一帧(视频剪辑、视频转动图、截取动图片段),请使用 frame 的区间写法,见 视频剪辑与动图转换。
使用示例
原视频:https://demo.bitiful.com/hdr-img/rainbow.mov
截取第 4950 毫秒的画面,并缩放到 1000 宽:https://demo.bitiful.com/hdr-img/rainbow.mov? frame=4950 & w=1000
自动选封面帧:
https://demo.bitiful.com/hdr-img/rainbow.mov?frame=auto&w=1000