视频抽帧节点用于从视频中截取单帧图片，将某一时刻的视频画面保存为静态图片。 ## 节点说明 扣子平台的视频抽帧节点支持从上传的视频中截取单帧图片，适用于视频内容分析、图片素材提取、制作视频封面、视频摘要总结等场景。 你可以通过配置抽取方式、抽取帧数或抽取间隔，指定抽帧策略，从而高效地截取所需的图片。 * 选择定数抽帧时，基于固定帧数自动抽帧。 * 选择等时抽帧时，基于固定间隔时间自动抽帧。 * 选择抽取关键帧时，在视频关键节点处自动抽帧。 ## 配置节点 ### 输入 视频抽帧节点的输入参数固定为**视频**，表示从上传的视频中截取图片。**视频**参数为 video 类型，支持如下两种输入方式： * 固定值：直接上传视频。 * 变量：引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量，实现视频的动态输入。引用的变量需为 video 类型。如果要引用的变量值为视频 URL，string 类型，则你需要先将 string 类型转换为 video 类型，例如添加一个子工作流节点（只有开始节点和结束节点），完成数据类型转换。  ### 配置 在**配置**区域，支持配置**抽帧方式**和**抽取帧数**，指定抽帧策略。 | **参数** | **说明** | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 抽帧方式 | 设置视频截屏的抽取方式。* 定数抽帧：系统根据视频时长和指定的抽取帧数，计算抽帧间隔，动态地从视频中抽取指定数量的图片。* 等时抽帧：每隔一段固定时间抽取一帧。* 抽取关键帧：在视频内容变化、场景切换或动作关键节点处自动抽取帧。 | | 抽取帧数 | 设置**抽取方式**为**定数抽帧**时，需设置抽取的帧数，最大值为 100。 | | 抽帧间隔 | 设置**抽取方式**为**等时抽帧**时，需设置抽取间隔，最大值为 1000000。单位为毫秒。 | ### 输出 节点的输出参数固定为以下参数： | **输出参数** | **说明** | | ------------------------- | -------------------------------------------------------------------- | | data.chunks.index | data.chunks 是数组类型，index 为数组的索引，即抽取到的视频图片索引。 | | data.chunks.screenshot | 抽取到的视频图片 URL。 | | data.chunks.timestamp\_ms | 抽取到的视频图片时间戳，表示截图在视频中的具体时间点，单位：毫秒。 | | msg | 节点执行状态，success 表示执行成功。 | | log\_id | 日志 ID。 | ## 示例 在工作流中添加**视频抽帧**节点时，需上传视频及设置抽取方式等配置。例如上传一个 10 秒的视频，指定每隔 1000 毫秒截取一次，最终将抽取 11 张截图，然后输入给视觉理解大模型，让大模型输出基于抽帧图片输出视频的摘要总结。示例中的节点说明如下： * 在**开始**节点，使用默认的输入参数 input，设置为 File 类型，用于动态上传**视频抽帧**节点所需的视频。 * 在**视频抽帧**节点，设置**视频**参数引用开始节点的 input 参数；设置**抽取方式**为**等时抽取**，**抽取间隔**为 **1000**。 * 在**大模型**节点，新增输入参数 input，引用**视频抽帧**节点输出结果中的 chunks 参数，用于输入截图链接，并且选择视觉理解相关的大模型，设置对应的提示词。 * 在**结束**节点，设置输出变量 output ，引用**大模型**节点的输出参数output，输出视频的摘要信息。