SaveVideo 视频持久化存储与磁盘写入节点
节点核心功能 (What is it?)
SaveVideo 节点是一个实用的视频 I/O 工具节点，允许创作者将工作流中生成、合成、调色或剪辑完成的视频工件导出并持久化保存至本地计算机的磁盘目录中。
典型适用场景 (When would I use it?)
在以下情况下使用 SaveVideo 节点：
- 将工作流渲染完成的高清视频导出并永久保存在本地；
- 为批处理生成式视频管线设置最终的文件落地终点；
- 保存中间调试阶段的渲染成果以供后续外部播放器审阅；
- 归档存储多媒体视频项目资产。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 SaveVideo 节点。
- 将待保存的视频来源连接至
video输入插槽。 - （可选）在
output_path中指定具体的目标文件路径与名称，或点击交互式保存按钮浏览目录。 - 执行工作流，视频文件将自动写入并持久化至本地磁盘。
参数输入插槽 (Parameters)
- video：待保存的目标视频流（原生支持
VideoArtifact、VideoUrlArtifact以及标准视频字典对象）。 - output_path：写入的目标系统文件物理路径（默认值：
"griptape_nodes.mp4"）。
输出引脚 (Outputs)
- output_path：成功写入的目标物理文件路径字符串（确认保存成功凭证）。
典型工作流示例 (Example)
保存调色完成的视频短片：
- 在画布中添加 SaveVideo 节点。
- 将调色节点的输出连入本节点的
video输入端。 - 将
output_path设为"F:/exports/my_cinematic_video.mp4"。 - 执行工作流，视频将被完整写入到指定路径。
关键技术特性 (Important Notes)
- 格式自动推断：支持常见视频扩展名（
.mp4、.avi、.mov、.webm等），若未显式输入后缀名，系统默认以.mp4格式安全封装； - 目录递归自动创建：若指定的输出路径包含尚不存在的多级父级文件夹，节点底层会自动递归创建目录树；
- UI 原生文件选择器：节点面板附带交互式文件浏览按钮，方便直接调起操作系统的图形化保存窗口。
常见问题与排查 (Common Issues)
- 磁盘写权限受阻 (Permission Denied)：请确保当前操作系统运行用户对目标文件夹拥有写权限。
- 目标路径非法：请避免在文件名中填入操作系统保留的非法特殊符号。