工作流/音视频处理节点/视频抽帧节点
视频抽帧节点
更新于: 2026-06-24 15:44:40
低代码工作流中的视频抽帧节点用于从视频中截取单帧图片,将某一时刻的视频画面保存为静态图片。
视频抽帧节点支持从上传的视频中截取单帧图片,适用于视频内容分析、图片素材提取、制作视频封面、视频摘要总结等场景。
你可以通过配置抽取方式、抽取帧数或抽取间隔,指定抽帧策略,从而高效地截取所需的图片。
视频抽帧节点的输入参数固定为视频,表示从上传的视频中截取图片。视频参数为 video 类型,支持如下两种输入方式:
在配置区域,支持配置抽帧方式和抽取帧数,指定抽帧策略。
|
参数 |
说明 |
|---|---|
|
抽帧方式 |
设置视频截屏的抽取方式。
|
|
抽取帧数 |
设置抽取方式为定数抽帧时,需设置抽取的帧数,最大值为 100。 |
|
抽帧间隔 |
设置抽取方式为等时抽帧时,需设置抽取间隔,最大值为 1000000。单位为毫秒。 |
节点的输出参数固定为以下参数:
|
输出参数 |
说明 |
|---|---|
|
data.chunks.index |
data.chunks 是数组类型,index 为数组的索引,即抽取到的视频图片索引。 |
|
data.chunks.screenshot |
抽取到的视频图片 URL。 |
|
data.chunks.timestamp_ms |
抽取到的视频图片时间戳,表示截图在视频中的具体时间点,单位:毫秒。 |
|
msg |
节点执行状态,success 表示执行成功。 |
|
log_id |
日志 ID。 |
默认情况下,节点运行超时、运行异常时,工作流会中断,工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式,例如整体执行超时、是否重试、是否跳转异常分支等。
|
异常处理设置 |
说明 |
|---|---|
|
整体执行超时 |
整体执行超时是指节点运行的最大耗时,如果超过此时长,则判断为该节点运行超时。 |
|
重试次数 |
节点运行超时或异常时,默认不重试,你也可以设置为重试 1 次。 |
|
异常处理方式 |
节点运行超时或异常时,默认中断工作流。你也可以手动修改此节点的异常处理方式:
|
在工作流中添加视频抽帧节点时,需上传视频及设置抽取方式等配置。例如上传一个 10 秒的视频,指定每隔 1000 毫秒截取一次,最终将抽取 11 张截图,然后输入给视觉理解大模型,让大模型输出基于抽帧图片输出视频的摘要总结。示例中的节点说明如下:
input,设置为 File<video> 类型,用于动态上传视频抽帧节点所需的视频。input 参数;设置抽取方式为等时抽取,抽取间隔为 1000。input,引用视频抽帧节点输出结果中的 chunks 参数,用于输入截图链接,并且选择视觉理解相关的大模型,设置对应的提示词。output ,引用大模型节点的输出参数output,输出视频的摘要信息。
效果如下:
原始视频
截图