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

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

参数	说明
抽帧方式	设置视频截屏的抽取方式。定数抽帧：系统根据视频时长和指定的抽取帧数，计算抽帧间隔，动态地从视频中抽取指定数量的图片。等时抽帧：每隔一段固定时间抽取一帧。抽取关键帧：在视频内容变化、场景切换或动作关键节点处自动抽取帧。
抽取帧数	设置抽帧方式为定数抽帧时，需设置抽取的帧数，最大值为 100。
抽帧间隔	设置抽帧方式为等时抽帧时，需设置抽取间隔，最大值为 1000000。单位为毫秒。

参数

说明

抽帧方式

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

抽取帧数

设置抽帧方式为定数抽帧时，需设置抽取的帧数，最大值为 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 格式。另外，节点还会返回输出参数 `isSuccess`、`errorBody`，传递节点异常的详细信息。执行异常流程：发生异常后，工作流运行不会中断，转而执行异常流程分析，开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 `isSuccess`、`errorBody` 返回。

整体执行超时

整体执行超时是指节点运行的最大耗时，如果超过此时长，则判断为该节点运行超时。

默认情况下，节点的超时时间为 60s，即 1 分钟。你也可以将其改为 0.1s~60s，灵活控制超时时间。

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

异常处理方式

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

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

示例

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

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

效果如下：

原始视频

截图

文档对您有帮助吗?