%20(1).png)
ComfyUI-WanVideoStartEndFrames 插件完全教程
1. 插件简介
插件地址： https://github.com/raindrop313/ComfyUI-WanVideoStartEndFrames
ComfyUI-WanVideoStartEndFrames 是一个超级强大的视频生成插件！它就像一个"时光魔法师"，能够根据你提供的开始帧和结束帧，自动生成中间的所有过渡画面，创造出流畅的视频动画。
这个插件能做什么？
想象一下，你有两张图片：
- 第一张：一个人站在门口
- 第二张：同一个人走到房间中央
WanVideoStartEndFrames 就能帮你自动生成这两张图片之间的所有过渡动作，让人物从门口自然地走到房间中央，就像拍摄了一段完整的视频！
能带来什么效果？
- 起止帧引导视频生成：只需提供开始和结束的两张图片，就能生成完整的视频序列
- 高质量视频输出：支持720P和480P两种分辨率的视频生成
- 智能过渡动画：自动计算并生成自然的中间帧动画
- 可控制的视频长度：支持生成不同帧数的视频，推荐25帧以上以保持角色一致性
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI
- 点击"Manager"按钮
- 搜索"WanVideoStartEndFrames"
- 找到作者为"raindrop313"的插件
- 点击安装
方法二：手动安装
- 打开命令行工具（Windows用户打开CMD，Mac用户打开终端）
- 进入ComfyUI的custom_nodes文件夹：
cd ComfyUI/custom_nodes/ - 下载插件：
git clone https://github.com/raindrop313/ComfyUI-WanVideoStartEndFrames.git - 进入插件文件夹：
cd ComfyUI-WanVideoStartEndFrames - 安装依赖包：
pip install -r requirements.txt
下载模型文件
你需要下载Wan2.1模型文件才能使用，具体下载方法请参考 ComfyUI-WanVideoWrapper 的说明。
3. 节点详细解析
3.1 WanVideo Model Loader(SE) 节点（万视频模型加载器）
这个节点就像一个"智能大脑装载机"，负责把WanVideo的AI大脑加载到内存里，为后续的视频生成做准备。它支持多种优化选项，就像给大脑装上不同的"加速器"。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | 下拉选择 | 根据你下载的模型 | 选择要使用的AI大脑文件，就像选择不同的专家 | 选择预训练的模型文件 | 选择下载的Wan2.1模型文件 |
| base_precision | base_precision | ["fp32", "bf16", "fp16", "fp16_fast"] | "bf16" | 计算精度选择，就像调节计算的精细程度 | 模型计算的数值精度 | bf16平衡速度和质量，fp32最精确但最慢 |
| quantization | quantization | 多种量化选项 | "disabled" | 模型压缩方式，就像给大脑"瘦身"以节省内存 | 模型量化方法选择 | disabled不压缩，fp8_e4m3fn轻度压缩节省内存 |
| load_device | load_device | ["main_device", "offload_device"] | "main_device" | 选择把模型放在哪个设备上，就像选择工作台 | 模型加载的设备位置 | main_device用显卡，offload_device用内存 |
| attention_mode | attention_mode | 多种注意力模式 | "sdpa" | 注意力计算方式，就像大脑思考的方法 | 注意力机制的实现方式 | sdpa标准模式，flash_attn更快但需要特殊支持 |
| compile_args | compile_args | WANCOMPILEARGS | 可选 | 编译优化参数，就像给大脑装上"涡轮增压" | 模型编译优化配置 | 可以提高运行速度，但可能增加启动时间 |
| block_swap_args | block_swap_args | BLOCKSWAPARGS | 可选 | 内存块交换参数，就像智能内存管理器 | 显存优化的块交换配置 | 帮助在显存不足时自动管理内存使用 |
| lora | lora | WANVIDLORA | 可选 | LoRA微调文件，就像给大脑装上"专业技能包" | LoRA适配器文件 | 可以加载特定风格或效果的微调模型 |
| vram_management_args | vram_management_args | VRAM_MANAGEMENTARGS | 可选 | 显存管理参数，就像内存清理大师 | 显存使用优化配置 | 更激进的内存节省方法，但可能影响速度 |
3.3 WanVideo VAE Loader(SE) 节点（万视频编解码器加载器）
这个节点就像一个"图像翻译官"，负责在图片和AI能理解的数字之间进行转换。它把图片变成数字让AI处理，然后再把数字变回图片给我们看。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model_name | model_name | 下拉选择 | 根据你下载的VAE | 选择图像编解码器文件，就像选择翻译官 | VAE模型文件选择 | 选择与主模型匹配的VAE文件 |
| precision | precision | ["fp16", "fp32", "bf16"] | "bf16" | 计算精度选择，就像调节翻译的精细程度 | VAE计算的数值精度 | bf16平衡质量和速度，fp32最精确 |
3.5 WanVideo SEI Clip Encode 节点（万视频图像编码器）
这个节点就像一个"图像理解专家"，它能够理解你提供的开始帧和结束帧图片，并为视频生成做好准备工作。它还能控制开始帧和结束帧在最终视频中的影响力。
3.6 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| clip_vision | clip_vision | CLIP_VISION | - | 图像理解模型，就像给AI装上"眼睛" | CLIP视觉编码器 | 连接CLIP模型来理解图片内容 |
| start | start | IMAGE | - | 开始帧图片，就像故事的第一幕 | 视频的起始帧图像 | 拖入你想要作为视频开头的图片 |
| end | end | IMAGE | - | 结束帧图片，就像故事的最后一幕 | 视频的结束帧图像 | 拖入你想要作为视频结尾的图片 |
| vae | vae | WANVAE | - | 图像编解码器，就像图片翻译官 | VAE编码器实例 | 连接VAE加载器的输出 |
| generation_width | generation_width | INT | 832 | 生成视频的宽度，就像画布的宽度 | 视频生成的像素宽度 | 832适合大多数情况，可根据需要调整 |
| generation_height | generation_height | INT | 480 | 生成视频的高度，就像画布的高度 | 视频生成的像素高度 | 480标准高度，720更高清但需要更多资源 |
| num_frames | num_frames | INT | 81 | 生成多少帧画面，就像决定视频有多长 | 生成的视频帧数 | 81帧约3-4秒，推荐25帧以上保持一致性 |
| force_offload | force_offload | BOOLEAN | True | 是否强制卸载模型，就像用完工具就收起来 | 处理完成后是否卸载模型 | True节省内存，False保持加载状态 |
| noise_aug_strength | noise_aug_strength | FLOAT | 0.0 | 噪声增强强度，就像给图片加点"随机性" | 噪声增强的强度参数 | 0.0无噪声，0.1轻微噪声增加运动感 |
| latent_strength | latent_strength | FLOAT | 1.0 | 潜在空间强度，就像调节图片的"影响力" | 潜在表示的乘数因子 | 1.0标准强度，<1.0允许更多运动变化 |
| clip_embed_strength | clip_embed_strength | FLOAT | 1.0 | CLIP嵌入强度，就像调节图片理解的"敏感度" | CLIP嵌入的乘数因子 | 1.0标准强度，可微调图片理解程度 |
| adjust_resolution | adjust_resolution | BOOLEAN | True | 是否调整分辨率，就像自动适配画面大小 | 是否执行分辨率调整 | True自动优化，False使用原始设置 |
| start_frame_weight | start_frame_weight | FLOAT | 1.0 | 开始帧权重，就像调节开头画面的"话语权" | 起始帧的影响权重 | >1.0增强开始帧影响，<1.0减弱影响 |
| end_frame_weight | end_frame_weight | FLOAT | 1.0 | 结束帧权重，就像调节结尾画面的"话语权" | 结束帧的影响权重 | >1.0增强结束帧影响，平衡控制过渡速度 |
3.7 Wan Video Sampler(SE) 节点（万视频采样器）
这个节点就像一个"视频创作大师"，它接收所有的设置和素材，然后开始真正的视频生成工作。它支持多种高级功能，就像专业的视频制作工具。
3.8 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | WANVIDEOMODEL | - | AI模型，就像请来的专业导演 | 预加载的模型实例 | 连接模型加载器的输出 |
| text_embeds | text_embeds | WANVIDEOTEXTEMBEDS | - | 文字描述信息，就像给导演的剧本 | 文本嵌入向量 | 连接文本编码器的输出 |
| image_embeds | image_embeds | WANVIDIMAGE_EMBEDS | - | 图像信息，就像给导演的分镜头 | 图像嵌入向量 | 连接图像编码器的输出 |
| steps | steps | INT | 30 | 生成步数，就像绘画的精细程度 | 扩散模型的去噪步数 | 30步平衡速度质量，50步更精细但更慢 |
| cfg | cfg | FLOAT | 6.0 | 引导强度，就像导演对剧本的严格程度 | 分类器自由引导强度 | 6.0适中，更高值更严格按描述生成 |
| shift | shift | FLOAT | 5.0 | 时间偏移参数，就像调节生成的"节奏" | 流匹配的时间偏移参数 | 5.0标准值，影响生成过程的时间分布 |
| seed | seed | INT | 0 | 随机种子，就像掷骰子的起始数字 | 随机数生成器种子 | 相同种子产生相同结果，不同种子不同效果 |
| force_offload | force_offload | BOOLEAN | True | 是否强制卸载，就像用完工具就收起来 | 采样完成后是否卸载模型 | True节省内存，False保持模型在内存中 |
| scheduler | scheduler | 多种调度器选项 | "unipc" | 采样调度器，就像选择不同的工作方式 | 扩散采样的调度算法 | unipc平衡，euler简单快速，dpm++高质量 |
| riflex_freq_index | riflex_freq_index | INT | 0 | RIFLEX频率索引，就像调节动画的"韵律感" | RIFLEX算法的频率参数 | 0禁用，6默认值，允许生成新帧而不循环 |
| samples | samples | LATENT | 可选 | 初始潜在向量，就像给画家一张草稿 | 用于视频到视频的初始潜在表示 | 可用于基于现有视频进行修改 |
| denoise_strength | denoise_strength | FLOAT | 1.0 | 去噪强度，就像调节修改的程度 | 去噪过程的强度 | 1.0完全重新生成，0.5保留一半原始内容 |
| feta_args | feta_args | FETAARGS | 可选 | FETA增强参数，就像视频质量提升器 | FETA算法的配置参数 | 可以提升视频质量和细节表现 |
| context_options | context_options | WANVIDCONTEXT | 可选 | 上下文选项，就像智能内存管理 | 上下文窗口的配置选项 | 用于长视频生成时的内存优化 |
| teacache_args | teacache_args | TEACACHEARGS | 可选 | TeaCache参数，就像智能缓存系统 | TeaCache优化的配置参数 | 可以加速生成过程，减少重复计算 |
| flowedit_args | flowedit_args | FLOWEDITARGS | 可选 | FlowEdit参数，就像视频编辑工具 | FlowEdit算法的配置参数 | 用于高级的视频编辑和修改功能 |
| slg_args | slg_args | SLGARGS | 可选 | SLG参数，就像智能生成助手 | SLG算法的配置参数 | 可以改善生成质量和一致性 |
3.9 Wan Video SEI Decode 节点（万视频解码器）
这个节点就像一个"视频冲印师"，它把采样器生成的数字信息转换成我们能看到的真正视频画面，并将开始帧和结束帧正确地放置在视频的首尾。
3.10 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| vae | vae | WANVAE | - | 图像编解码器，就像数字到图片的翻译官 | VAE解码器实例 | 连接VAE加载器的输出 |
| samples | samples | LATENT | - | 采样结果，就像待冲洗的"数字胶卷" | 采样器生成的潜在表示 | 连接采样器的输出 |
| start | start | IMAGE | - | 开始帧图片，就像视频的开头画面 | 视频的起始帧图像 | 与编码器中使用的相同开始帧 |
| end | end | IMAGE | - | 结束帧图片，就像视频的结尾画面 | 视频的结束帧图像 | 与编码器中使用的相同结束帧 |
| enable_vae_tiling | enable_vae_tiling | BOOLEAN | True | 是否启用分块处理，就像分段冲洗照片 | 是否使用VAE分块解码 | True大幅减少内存使用，可能有接缝 |
| tile_x | tile_x | INT | 272 | X方向分块大小，就像横向切片的大小 | 水平方向的分块像素大小 | 272平衡内存和质量，更小值省内存 |
| tile_y | tile_y | INT | 272 | Y方向分块大小，就像纵向切片的大小 | 垂直方向的分块像素大小 | 272平衡内存和质量，更小值省内存 |
| tile_stride_x | tile_stride_x | INT | 144 | X方向分块步长，就像横向切片的间隔 | 水平方向分块的步进像素 | 144标准步长，更小值减少接缝但用更多内存 |
| tile_stride_y | tile_stride_y | INT | 128 | Y方向分块步长，就像纵向切片的间隔 | 垂直方向分块的步进像素 | 128标准步长，更小值减少接缝但用更多内存 |
4. 使用技巧和建议
4.1 图片准备技巧
- 风格一致性：开始帧和结束帧最好是同一场景、同一风格的图片
- 构图相似：两张图片的构图角度不要差太多，否则过渡会很突兀
- 清晰度要求：使用高清晰度的图片，效果会更好
- 内容连贯性：确保开始帧和结束帧在逻辑上能够连接
4.2 参数调优建议
新手推荐设置：
- steps: 30（平衡速度和质量）
- cfg: 6.0（适中的引导强度）
- num_frames: 81（约3-4秒视频）
- scheduler: "unipc"（稳定可靠）
高质量设置：
- steps: 50（更高质量）
- cfg: 8.0（更强引导）
- num_frames: 121（更长视频）
- base_precision: "bf16"（平衡精度和速度）
快速预览设置：
- steps: 20（更快生成）
- num_frames: 41（较短视频）
- enable_vae_tiling: True（节省内存）
4.3 内存优化技巧
- 低显存用户：启用quantization，选择"fp8_e4m3fn"
- 超低显存：使用vram_management_args进行激进内存管理
- 高显存用户：可以增加num_frames生成更长视频
4.4 帧权重控制技巧
- 强化开始帧：start_frame_weight设为1.5-2.0
- 强化结束帧：end_frame_weight设为1.5-2.0
- 平衡过渡：两个权重都设为1.0
- 创意效果：一个设高一个设低，创造不对称过渡
5. 常见问题解答
Q1：为什么生成的视频质量不好？
A： 可能的原因和解决方法：
- 开始帧和结束帧差异太大 → 选择更相似的图片
- steps参数太小 → 增加到40-50
- 没有提供文字描述 → 添加正面提示词描述动作
- num_frames太少 → 增加到25帧以上
Q2：视频中角色不一致怎么办？
A： 解决方案：
- 确保num_frames至少25帧
- 使用相同角色、相同风格的开始和结束帧
- 调整start_frame_weight和end_frame_weight平衡影响
- 在文字描述中强调角色一致性
Q3：生成速度太慢怎么办？
A： 优化方法：
- 减少steps到20-30
- 启用quantization压缩模型
- 使用较小的分辨率
- 启用teacache_args加速
Q4：出现显存不足错误？
A： 解决方案：
- 启用enable_vae_tiling
- 使用quantization="fp8_e4m3fn"
- 配置vram_management_args
- 减少num_frames和分辨率
Q5：视频过渡不自然怎么办？
A： 改善方法：
- 调整cfg值到4.0-8.0之间
- 修改start_frame_weight和end_frame_weight
- 增加noise_aug_strength添加随机性
- 确保开始帧和结束帧逻辑连贯
Q6：什么时候需要文字描述？
A： 重要提醒：
- 必须提供正面提示词：没有文字描述会导致严重的视频扭曲
- 描述应该包含动作过程，如"人物从左走到右"
- 描述要与开始帧和结束帧的内容一致
- 可以描述场景、动作、情感等细节
6. 实际应用案例
案例1：人物走路动画
- 开始帧：人物站在门口
- 结束帧：人物站在房间中央
- 文字描述："一个人慢慢从门口走到房间中央"
- 参数设置：num_frames=81, steps=40, cfg=7.0
案例2：表情变化动画
- 开始帧：人物严肃表情
- 结束帧：人物微笑表情
- 文字描述："人物表情从严肃变为微笑"
- 参数设置：num_frames=41, steps=35, cfg=6.5
案例3：场景转换动画
- 开始帧：白天的街道
- 结束帧：夜晚的同一条街道
- 文字描述："街道从白天过渡到夜晚"
- 参数设置：num_frames=121, steps=50, cfg=8.0
7. 工作流程建议
基础工作流程：
- WanVideo Model Loader(SE) → 加载AI模型
- WanVideo VAE Loader(SE) → 加载图像编解码器
- WanVideo SEI Clip Encode → 编码开始帧和结束帧
- Wan Video Sampler(SE) → 生成视频潜在表示
- Wan Video SEI Decode → 解码成最终视频
高级工作流程：
- 添加文本编码器节点处理提示词
- 使用LoRA节点加载特定风格
- 配置高级优化参数提升性能
- 使用后处理节点增强视频质量
8. 进阶技巧
8.1 长视频生成
- 使用context_options进行上下文窗口管理
- 配置适当的context_frames和context_overlap
- 启用freenoise减少重复模式
8.2 性能优化
- 使用teacache_args缓存重复计算
- 配置block_swap_args智能内存管理
- 启用compile_args编译优化（需要时间预热）
8.3 质量提升
- 使用feta_args增强视频质量
- 调整noise_aug_strength增加细节
- 平衡start_frame_weight和end_frame_weight
8.4 创意应用
- 时间流逝：同一场景的不同时间状态
- 情绪转换：人物情绪的渐变过程
- 物体变形：物体形状的平滑变化
- 场景切换：不同场景间的自然过渡
9. 性能优化指南
9.1 硬件要求
- 最低配置：12GB显存的显卡
- 推荐配置：16GB以上显存的显卡
- 理想配置：24GB显存用于高分辨率长视频
9.2 内存优化策略
- 启用VAE分块处理
- 使用模型量化
- 配置显存管理参数
- 及时卸载不用的模型
9.3 速度优化策略
- 使用TeaCache缓存
- 启用模型编译
- 选择合适的调度器
- 平衡质量和速度参数
10. 总结
ComfyUI-WanVideoStartEndFrames 是一个功能强大的起止帧引导视频生成插件，特别适合：
- 动画制作者创建平滑的过渡动画
- 内容创作者制作短视频内容
- 研究人员探索视频生成技术
- 任何想要创建高质量过渡动画的用户
这个插件的核心优势在于：
- 精确控制：通过起止帧精确控制视频内容
- 高质量输出：支持720P高清视频生成
- 灵活配置：丰富的参数选项满足不同需求
- 性能优化：多种优化选项适应不同硬件配置
记住，好的视频需要：
- 逻辑连贯的开始帧和结束帧
- 准确的文字描述（必须提供！）
- 合适的参数设置
- 足够的硬件资源
多尝试不同的参数组合和创意想法，你会发现这个插件在视频生成方面的无限可能！