视频截图/截帧

本文介绍截帧相关功能介绍、注意事项、效果图、使用方法以及案例讲解。

功能介绍

您可以根据需求对上传的视频或动图文件进行图片截取，veImageX 支持智能模式和指定时间模式两种方式。

• 智能模式：仅智能截取输出一张图片，您在上传素材时需要尽量避免首帧为黑白、透明图等无意义图。
• 指定时间模式：指定一组时间，截取素材在这组时间点的图像。如果输入的时间超出素材长度，则会返回素材的最后一帧。

注意事项

• 建议素材文件的编码格式为 H.264 和 H.265。

• veImageX 默认不保存截帧的图片，请您手动下载结果图并保存至本地。

• 您可以将结果图与 veImageX 其他支持的任意图像处理功能例如裁剪、缩放等进行组合处理，从而查看多种图片处理效果。

• 截帧为 veImageX 的增值能力，其计费详情请参见后付费-按量计费。

效果图

以下为您展示了指定截帧时间为 8000ms 时的效果图，结果图访问地址如下所示，您可以在网站输入该地址查看完整图片效果：

http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example-mv.mov~tplv-x9vch4xmek-TimeOffsetMs-v3:8000.webp

视频示例
截帧结果图

使用方法

使用控制台

Step 1：创建模板

您可以通过登录 veImageX 控制台创建模板，具体操作详情请参考新建模板。

Step 2：获取结果图访问地址

如果您已在控制台创建好模板，则在控制台获取您的结果图。获取访问地址的具体操作请参考获取结果图 URL。

使用 OpenAPI

Step 1：创建模板

您可以通过调用 CreateImageTemplate创建您的模板，veImageX 也支持在该接口与其他功能进行组合配置创建模板。

Step 2：获取结果图访问地址

在创建模板后，您可以通过调用 GetResourceURL获取经模板处理后的结果图访问地址。

案例讲解

在调用 CreateImageTemplate 接口创建模板时，您需要设置Snapshot组合参数配置您的图片处理功能配置。

上图案例中截帧时间戳为 8000ms 的Snapshot请求示例如下所示。

"Snapshot":{
      "Type":"offset",      //截帧类型。default：智能截图；offset：指定时间戳截图。
      "TimeOffsetMs":8000      //截帧时间戳，单位为 ms。
   },