跳到正文
控制台

视频和动图截帧

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

视频截帧:第 4950 毫秒

自动选封面帧:

https://demo.bitiful.com/hdr-img/rainbow.mov?frame=auto&w=1000