> ## Documentation Index > Fetch the complete documentation index at: https://docs.coze.cn/llms.txt > Use this file to discover all available pages before exploring further. 低代码工作流中的视频抽帧节点用于从视频中截取单帧图片，将某一时刻的视频画面保存为静态图片。 ## 节点说明 {#004089a2} 视频抽帧节点支持从上传的视频中截取单帧图片，适用于视频内容分析、图片素材提取、制作视频封面、视频摘要总结等场景。 你可以通过配置抽取方式、抽取帧数或抽取间隔，指定抽帧策略，从而高效地截取所需的图片。 * 选择定数抽帧时，基于固定帧数自动抽帧。 * 选择等时抽帧时，基于固定间隔时间自动抽帧。 * 选择抽取关键帧时，在视频关键节点处自动抽帧。 ## 配置节点 {#a8576e43} ### 输入 {#c1e4e255} 视频抽帧节点的输入参数固定为**视频**，表示从上传的视频中截取图片。**视频**参数为 video 类型，支持如下两种输入方式： * 固定值：直接上传视频。 * 变量：引用开始节点的输入参数、上游节点的输出参数、用户变量、应用变量、系统变量等变量，实现视频的动态输入。引用的变量需为 video 类型。如果要引用的变量值为视频 URL，string 类型，则你需要先将 string 类型转换为 video 类型，例如添加一个子工作流节点（只有开始节点和结束节点），完成数据类型转换。 ![Image=587x164](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6245d2cd9df54f31b649510c9a285310~tplv-goo7wpa0wc-image.image) ### 配置 {#796728ea} 在**配置**区域，支持配置**抽帧方式**和**抽取帧数**，指定抽帧策略。 | | | \ |**参数** |**说明** | |---|---| | | | \ |抽帧方式 |设置视频截屏的抽取方式。 |\ | | |\ | |* 定数抽帧：系统根据视频时长和指定的抽取帧数，计算抽帧间隔，动态地从视频中抽取指定数量的图片。 |\ | |* 等时抽帧：每隔一段固定时间抽取一帧。 |\ | |* 抽取关键帧：在视频内容变化、场景切换或动作关键节点处自动抽取帧。 | | | | \ |抽取帧数 |设置**抽取方式**为**定数抽帧**时，需设置抽取的帧数，最大值为 100。 | | | | \ |抽帧间隔 |设置**抽取方式**为**等时抽帧**时，需设置抽取间隔，最大值为 1000000。单位为毫秒。 | ### 输出 {#73c18f1d} 节点的输出参数固定为以下参数： | | | \ |**输出参数** |**说明** | |---|---| | | | \ |data.chunks.index |data.chunks 是数组类型，index 为数组的索引，即抽取到的视频图片索引。 | | | | \ |data.chunks.screenshot |抽取到的视频图片 URL。 | | | | \ |data.chunks.timestamp_ms |抽取到的视频图片时间戳，表示截图在视频中的具体时间点，单位：毫秒。 | | | | \ |msg |节点执行状态，success 表示执行成功。 | | | | \ |log_id |日志 ID。 | ## 异常处理 {#e5e3965e} 默认情况下，节点运行超时、运行异常时，工作流会中断，工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式，例如整体执行超时、是否重试、是否跳转异常分支等。 | | | \ |**异常处理设置** |**说明** | |---|---| | | | \ |整体执行超时 |整体执行超时是指节点运行的最大耗时，如果超过此时长，则判断为该节点运行超时。 |\ | |默认情况下，节点的超时时间为 60s，即 1 分钟。你也可以将其改为 0.1s~60s，灵活控制超时时间。 | | | | \ |重试次数 |节点运行超时或异常时，默认不重试，你也可以设置为重试 1 次。 | | | | \ |异常处理方式 |节点运行超时或异常时，默认中断工作流。你也可以手动修改此节点的异常处理方式： |\ | | |\ | |* **中断流程**：工作流执行中断，不再运行后续节点。 |\ | |* **返回设定内容**：发生异常后，工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容，必须是输出中已定义的字段，且格式为合法的 JSON 格式。另外，节点还会返回输出参数 `isSuccess`、`errorBody`，传递节点异常的详细信息。 |\ | |* **执行异常流程**：发生异常后，工作流运行不会中断，转而执行异常流程分析，开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 `isSuccess`、`errorBody` 返回。 | ![Image=384x202](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b9d0b55350dc49479d196674b450f68f~tplv-goo7wpa0wc-image.image) ## 示例 {#bbe9815e} 在工作流中添加**视频抽帧**节点时，需上传视频及设置抽取方式等配置。例如上传一个 10 秒的视频，指定每隔 1000 毫秒截取一次，最终将抽取 11 张截图，然后输入给视觉理解大模型，让大模型输出基于抽帧图片输出视频的摘要总结。示例中的节点说明如下： * 在**开始**节点，使用默认的输入参数 `input`，设置为 `File