%20(1).png)
ComfyUI-AnimateDiff 插件保姆级教程
1. 插件简介
插件地址： https://github.com/SipherAGI/comfyui-animatediff
ComfyUI-AnimateDiff 是一个超级神奇的"静图变动图"插件！它就像给你的 ComfyUI 装了一个"魔法动画师"，能够把静态图片变成流畅的动画 GIF 或视频。
这个插件能干啥？
- 把静态图片变成动态 GIF 动画
- 支持多种视频格式输出（GIF、WebP、MP4、WebM等）
- 可以控制动画的帧数、速度和循环次数
- 支持长时间动画的滑动窗口技术
- 可以加载视频作为输入进行风格转换
- 支持 LoRA 模型增强动画效果
- 能够处理超长动画序列
工作原理（大白话版）：
想象你有一本翻页动画书，每一页都是一张静态图片，快速翻动就能看到动画效果。AnimateDiff 就像一个超级聪明的动画师，它会根据你的描述，自动画出一系列连贯的图片，然后把这些图片组合成流畅的动画。它使用了特殊的"运动模块"来理解物体应该如何移动。
2. 如何安装
手动安装方法
- 找到你的 ComfyUI 文件夹，进入
custom_nodes目录 - 在这里打开命令行（终端）
- 输入命令：
git clone https://github.com/SipherAGI/comfyui-animatediff.git - 进入插件文件夹：
cd comfyui-animatediff - 安装依赖：
pip install -r requirements.txt - 重要：下载运动模块文件
- 访问 Google Drive 或 HuggingFace
- 下载运动模块文件（如
mm_sd_v15_v2.ckpt） - 将文件放到
comfyui-animatediff/models/文件夹中
- 可选：下载 LoRA 文件
- 从 HuggingFace LoRA页面 下载
- 放到
comfyui-animatediff/loras/文件夹中
- 重启 ComfyUI
3. 节点详细解析
3.1 Animate Diff Module Loader 节点 - 动画模块加载器
这个节点是干嘛的？
这个节点就像一个"动画大脑安装器"，它负责加载 AnimateDiff 的运动模块。运动模块就像一个专门理解物体如何运动的智能大脑，它知道人怎么走路、水怎么流动、云怎么飘动等等。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model_name | model_name | 下拉选择 | mm_sd_v15_v2.ckpt | 选择要使用的动画大脑，就像选择不同技能的动画师 | 运动模块模型文件选择 | v2版本支持LoRA，v1版本更稳定 |
| lora_stack | lora_stack | MOTION_LORA_STACK类型 | - | 可选的动画风格增强包，就像给动画师额外的技能书 | 可选的运动LoRA堆栈 | 连接LoRA加载器来增强特定动画效果 |
3.2 Animate Diff Lora Loader 节点 - 动画LoRA加载器
这个节点是干嘛的？
这个节点就像一个"动画技能书管理器"，它可以给动画模块添加特殊的动画技能。比如让人物动作更自然、让相机运动更平滑等等。就像给画家提供不同风格的画笔。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| lora_name | lora_name | 下拉选择 | - | 选择要使用的动画技能包，就像选择不同的动画风格 | LoRA模型文件选择 | 选择适合你动画类型的LoRA文件 |
| alpha | alpha | 0.0-10.0 | 1.0 | 技能包的影响强度，就像调节特效的浓度 | LoRA权重强度 | 1.0是标准强度，0.5是轻微效果，2.0是强烈效果 |
| lora_stack | lora_stack | MOTION_LORA_STACK类型 | - | 已有的技能包堆栈，可以叠加多个技能 | 输入的LoRA堆栈 | 连接其他LoRA加载器实现多重效果 |
3.3 Animate Diff Sampler 节点 - 动画采样器
这个节点是干嘛的？
这是插件的核心工作节点，就像一个"动画制作工厂"。它把所有材料（模型、提示词、运动模块）组合起来，按照你的要求制作出一系列连贯的动画帧。就像一个会按照剧本拍摄连续镜头的导演。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| motion_module | motion_module | MOTION_MODULE类型 | - | 动画大脑，告诉AI如何制作动画 | 运动模块输入 | 连接Module Loader的输出 |
| inject_method | inject_method | default/legacy | default | 动画大脑的安装方式，就像选择兼容模式 | 运动模块注入方法 | default适合新模型，legacy适合老模型 |
| frame_number | frame_number | 2-10000 | 16 | 动画有多少帧，就像决定拍多少张照片 | 动画帧数 | 16帧约2秒，24帧约3秒（按8fps计算） |
| model | model | MODEL类型 | - | 基础的AI绘画模型，就像画家的基本技能 | 扩散模型输入 | 连接模型加载器 |
| seed | seed | 整数 | 随机 | 随机种子，控制动画的随机性 | 随机数种子 | 固定数值可重现相同动画 |
| steps | steps | 整数 | 20 | 绘制每帧的精细程度，就像画画的遍数 | 采样步数 | 20步够用，30步更精细 |
| cfg | cfg | 浮点数 | 7.0 | AI对提示词的遵循程度 | CFG引导强度 | 7.0是标准值，太高可能过度拟合 |
| sampler_name | sampler_name | 下拉选择 | euler | 绘画的方法，就像选择画笔类型 | 采样器类型 | euler适合动画，dpm++适合质量 |
| scheduler | scheduler | 下拉选择 | normal | 绘画过程的时间安排 | 调度器类型 | normal是标准，karras更平滑 |
| positive | positive | CONDITIONING类型 | - | 正面描述，告诉AI要画什么 | 正向条件输入 | 连接正面提示词编码器 |
| negative | negative | CONDITIONING类型 | - | 负面描述，告诉AI不要画什么 | 负向条件输入 | 连接负面提示词编码器 |
| latent_image | latent_image | LATENT类型 | - | 画布，动画在这上面绘制 | 潜在图像输入 | 连接空白潜在图像或现有图像 |
| denoise | denoise | 0.0-1.0 | 1.0 | 重绘程度，1.0是完全重绘 | 去噪强度 | 1.0全新生成，0.5半重绘 |
| sliding_window_opts | sliding_window_opts | SLIDING_WINDOW_OPTS类型 | - | 长动画的分段处理选项 | 滑动窗口选项 | 连接滑动窗口选项节点 |
3.4 Sliding Window Options 节点 - 滑动窗口选项
这个节点是干嘛的？
这个节点就像一个"长电影分段拍摄计划器"。当你要制作很长的动画时，一次性处理所有帧会占用太多内存，这个节点就把长动画分成小段来处理，每段之间有一点重叠确保连贯性。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| context_length | context_length | 2-32 | 16 | 每段动画的长度，就像每次拍摄多少个镜头 | 上下文窗口长度 | 16是最佳值，显存不够可以调到8 |
| context_stride | context_stride | 1-32 | 1 | 采样间隔，就像每隔几帧取一帧 | 上下文步长 | 1是每帧都要，2是隔帧采样 |
| context_overlap | context_overlap | 0-32 | 4 | 段与段之间的重叠帧数，确保连贯性 | 上下文重叠 | 4帧重叠保证平滑过渡 |
| context_schedule | context_schedule | 下拉选择 | uniform | 分段的时间安排方式 | 上下文调度策略 | uniform是均匀分布 |
| closed_loop | closed_loop | 布尔值 | False | 是否制作循环动画，首尾相连 | 是否闭合循环 | True制作无缝循环GIF |
3.5 Animate Diff Combine 节点 - 动画合成器
这个节点是干嘛的？
这个节点就像一个"动画后期制作工作室"，它把一系列静态图片组合成最终的动画文件。可以调整播放速度、循环次数、文件格式等，就像视频编辑软件的导出功能。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | IMAGE类型 | - | 要合成的图片序列，就像动画的每一帧 | 输入图像序列 | 连接采样器的图像输出 |
| frame_rate | frame_rate | 1-24 | 8 | 播放速度，每秒显示多少帧 | 帧率设置 | 8fps适中，12fps流畅，24fps电影级 |
| loop_count | loop_count | 0-100 | 0 | 循环播放次数，0表示无限循环 | 循环次数 | 0无限循环，1播放一次，3循环三次 |
| save_image | save_image | 布尔值 | True | 是否保存到硬盘 | 是否保存文件 | True保存文件，False只预览 |
| filename_prefix | filename_prefix | 字符串 | animate_diff | 文件名前缀，就像给文件起名字 | 文件名前缀 | 自定义文件名便于管理 |
| format | format | 下拉选择 | image/gif | 输出格式，就像选择文件类型 | 输出格式选择 | gif兼容性好，webp压缩率高，mp4质量佳 |
| pingpong | pingpong | 布尔值 | False | 是否来回播放，就像钟摆动画 | 乒乓球效果 | True会正放倒放循环 |
3.6 Load Video 节点 - 视频加载器
这个节点是干嘛的？
这个节点就像一个"视频拆解器"，它可以把现有的视频或GIF文件拆解成一帧一帧的图片，然后你可以用这些图片作为其他节点的输入。就像把电影胶片一格一格地取出来。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| video | video | 下拉选择 | - | 要加载的视频文件，就像选择要拆解的电影胶片 | 视频文件选择 | 选择input/video文件夹中的视频 |
| frame_start | frame_start | 0-很大数字 | 0 | 从第几帧开始提取，就像选择从电影的第几分钟开始 | 起始帧位置 | 0从头开始，30跳过前30帧 |
| frame_limit | frame_limit | 1-10240 | 16 | 最多提取多少帧，就像决定要多少张照片 | 帧数限制 | 16帧适合短动画，64帧适合长动画 |
3.7 Get Image Size + Batch Size 节点 - 图像尺寸获取器
这个节点是干嘛的？
这个节点就像一个"图片信息检查器"，它可以告诉你图片的宽度、高度和有多少张图片。就像用尺子测量照片的大小和数量。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | IMAGE类型 | - | 要检查的图片，就像要测量的照片 | 输入图像 | 连接任何图像输出节点 |
3.8 Image Chunking 节点 - 图像分块器
这个节点是干嘛的？
这个节点就像一个"照片分组器"，它可以把一大堆图片按照指定数量分成几个小组。比如你有100张照片，可以分成每组16张的小堆，方便分别处理。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | IMAGE类型 | - | 要分组的图片堆，就像一摞照片 | 输入图像序列 | 连接图像输出节点 |
| chunk_size | chunk_size | 1-1024 | 16 | 每组多少张图片，就像每个小堆放几张照片 | 分块大小 | 16适合动画处理，32适合大批量 |
| allow_remainder | allow_remainder | 布尔值 | True | 是否允许最后一组数量不足，就像最后一堆可以少几张 | 是否允许余数 | True允许不完整分组，False要求整除 |
3.9 前端JavaScript功能 - 视频预览和上传
这些功能是干嘛的？
这些是隐藏在后台的"用户界面增强器"，它们让你在ComfyUI界面中可以直接预览动画效果，还可以方便地上传视频文件。就像给软件界面添加了更友好的功能按钮。
功能说明：
- 视频预览功能： 在节点上直接显示生成的动画预览
- 视频上传功能： 提供上传按钮，方便添加视频文件
- 格式支持： 支持多种视频和图像格式的预览和上传
4. 使用技巧和建议
4.1 新手推荐设置
基础动画制作：
- frame_number: 16（约2秒动画）
- frame_rate: 8（流畅度适中）
- steps: 20-30（质量与速度平衡）
- cfg: 7.0（标准引导强度）
长动画制作：
- 使用Sliding Window Options节点
- context_length: 16（最佳效果）
- context_overlap: 4（保证连贯性）
- 总帧数可以设置到100+
4.2 不同场景的参数建议
人物动画：
- 使用人物相关的LoRA
- frame_rate: 8-12fps
- 避免过于复杂的动作描述
风景动画：
- 适合云朵飘动、水流等自然运动
- frame_rate: 6-8fps
- 可以使用较长的帧数
物体动画：
- 适合旋转、移动等简单动作
- frame_rate: 8-12fps
- 注意保持物体的一致性
4.3 质量优化技巧
提高动画质量：
- 使用高质量的基础模型
- 增加采样步数到30-50
- 使用合适的LoRA增强效果
- 保持提示词简洁明确
提高生成速度：
- 降低frame_number
- 减少采样步数
- 使用较小的图像尺寸
- 选择快速的采样器
内存优化：
- 使用滑动窗口处理长动画
- 降低context_length
- 分批处理大量帧
4.4 工作流连接建议
基础动画工作流：
- 模型加载器 → AnimateDiff采样器
- 运动模块加载器 → AnimateDiff采样器
- 提示词编码器 → AnimateDiff采样器
- 空白潜在图像 → AnimateDiff采样器
- AnimateDiff采样器 → VAE解码器 → 动画合成器
高级动画工作流：
- 添加LoRA加载器增强效果
- 使用滑动窗口选项处理长动画
- 结合ControlNet控制动画内容
- 使用视频加载器进行风格转换
5. 常见问题解答
Q1：为什么生成的动画不连贯，像幻灯片一样？
A： 可能的原因和解决方法：
- 运动模块没有正确加载 → 检查模型文件是否下载完整
- 提示词过于复杂 → 简化描述，避免过多细节
- CFG值设置过高 → 降低到5-8之间
- 使用了不兼容的采样器 → 尝试euler或ddim
Q2：生成动画时显存不够怎么办？
A： 内存优化方法：
- 降低frame_number到8-12
- 使用滑动窗口，设置context_length为8
- 减小图像尺寸到512x512
- 降低采样步数到15-20
- 关闭xformers（添加--disable-xformers启动参数）
Q3：动画中出现水印怎么办？
A： 这是训练数据的问题：
- 避免使用mm_sd_v15模型
- 尝试使用社区优化的模型
- 在负面提示词中添加"watermark, logo"
- 使用其他运动模块
Q4：如何制作循环动画？
A： 循环动画设置：
- 在滑动窗口选项中开启closed_loop
- 在合成器中设置loop_count为0（无限循环）
- 或者开启pingpong效果
- 确保动画内容适合循环播放
Q5：支持哪些视频格式？
A： 支持的格式：
- 输出：GIF、WebP、MP4、WebM、H264、H265
- 输入：GIF、WebP、MP4、MOV、AVI、WebM
- 推荐使用WebP（压缩率高）或MP4（质量好）
Q6：LoRA不起作用怎么办？
A： LoRA使用注意事项：
- 只有v2版本的运动模块支持LoRA
- 确保LoRA文件放在正确的文件夹
- 调整alpha值到0.5-2.0之间
- 检查LoRA是否与当前模型兼容
6. 高级应用技巧
6.1 与ControlNet结合使用
- 使用姿态控制制作人物动画
- 使用深度图控制场景动画
- 结合多个ControlNet实现复杂控制
6.2 批量动画制作
- 使用图像分块器处理大量帧
- 设置合理的分块大小
- 利用循环处理提高效率
6.3 动画后期处理
- 使用外部软件进一步编辑
- 调整播放速度和效果
- 添加音频和特效
7. 总结
ComfyUI-AnimateDiff 是一个功能强大的动画生成插件，它将静态图像生成扩展到了动态动画领域。通过合理的参数设置和工作流设计，你可以创造出各种精彩的动画效果。
记住这几个要点：
- 确保正确下载和安装运动模块文件
- 从简单的16帧动画开始练习
- 合理设置内存和质量参数
- 利用滑动窗口技术制作长动画
- 多尝试不同的LoRA和参数组合
希望这个教程能帮助你更好地使用 AnimateDiff 插件，创造出令人惊艳的动画作品！🎬✨