助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
应用
资源
发布
模型
多人协作
开发工具
推广与变现

视频抽帧节点

更新于: 2026-06-24 15:44:40

低代码工作流中的视频抽帧节点用于从视频中截取单帧图片,将某一时刻的视频画面保存为静态图片。

节点说明

视频抽帧节点支持从上传的视频中截取单帧图片,适用于视频内容分析、图片素材提取、制作视频封面、视频摘要总结等场景。
你可以通过配置抽取方式、抽取帧数或抽取间隔,指定抽帧策略,从而高效地截取所需的图片。

  • 选择定数抽帧时,基于固定帧数自动抽帧。
  • 选择等时抽帧时,基于固定间隔时间自动抽帧。
  • 选择抽取关键帧时,在视频关键节点处自动抽帧。

配置节点

输入

视频抽帧节点的输入参数固定为视频,表示从上传的视频中截取图片。视频参数为 video 类型,支持如下两种输入方式:

  • 固定值:直接上传视频。
  • 变量:引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量,实现视频的动态输入。引用的变量需为 video 类型。如果要引用的变量值为视频 URL,string 类型,则你需要先将 string 类型转换为 video 类型,例如添加一个子工作流节点(只有开始节点和结束节点),完成数据类型转换。
    Image

配置

配置区域,支持配置抽帧方式抽取帧数,指定抽帧策略。

参数

说明

抽帧方式

设置视频截屏的抽取方式。

  • 定数抽帧:系统根据视频时长和指定的抽取帧数,计算抽帧间隔,动态地从视频中抽取指定数量的图片。
  • 等时抽帧:每隔一段固定时间抽取一帧。
  • 抽取关键帧:在视频内容变化、场景切换或动作关键节点处自动抽取帧。

抽取帧数

设置抽取方式定数抽帧时,需设置抽取的帧数,最大值为 100。

抽帧间隔

设置抽取方式等时抽帧时,需设置抽取间隔,最大值为 1000000。单位为毫秒。

输出

节点的输出参数固定为以下参数:

输出参数

说明

data.chunks.index

data.chunks 是数组类型,index 为数组的索引,即抽取到的视频图片索引。

data.chunks.screenshot

抽取到的视频图片 URL。

data.chunks.timestamp_ms

抽取到的视频图片时间戳,表示截图在视频中的具体时间点,单位:毫秒。

msg

节点执行状态,success 表示执行成功。

log_id

日志 ID。

异常处理

默认情况下,节点运行超时、运行异常时,工作流会中断,工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式,例如整体执行超时、是否重试、是否跳转异常分支等。

异常处理设置

说明

整体执行超时

整体执行超时是指节点运行的最大耗时,如果超过此时长,则判断为该节点运行超时。
默认情况下,节点的超时时间为 60s,即 1 分钟。你也可以将其改为 0.1s~60s,灵活控制超时时间。

重试次数

节点运行超时或异常时,默认不重试,你也可以设置为重试 1 次。

异常处理方式

节点运行超时或异常时,默认中断工作流。你也可以手动修改此节点的异常处理方式:

  • 中断流程:工作流执行中断,不再运行后续节点。
  • 返回设定内容:发生异常后,工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容,必须是输出中已定义的字段,且格式为合法的 JSON 格式。另外,节点还会返回输出参数 isSuccesserrorBody,传递节点异常的详细信息。
  • 执行异常流程:发生异常后,工作流运行不会中断,转而执行异常流程分析,开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 isSuccesserrorBody 返回。

Image

示例

在工作流中添加视频抽帧节点时,需上传视频及设置抽取方式等配置。例如上传一个 10 秒的视频,指定每隔 1000 毫秒截取一次,最终将抽取 11 张截图,然后输入给视觉理解大模型,让大模型输出基于抽帧图片输出视频的摘要总结。示例中的节点说明如下:

  • 开始节点,使用默认的输入参数 input,设置为 File<video> 类型,用于动态上传视频抽帧节点所需的视频。
  • 视频抽帧节点,设置视频参数引用开始节点的 input 参数;设置抽取方式等时抽取抽取间隔1000
  • 大模型节点,新增输入参数 input,引用视频抽帧节点输出结果中的 chunks 参数,用于输入截图链接,并且选择视觉理解相关的大模型,设置对应的提示词。
  • 结束节点,设置输出变量 output ,引用大模型节点的输出参数output,输出视频的摘要信息。

Image
效果如下:

原始视频

截图
Image