插件教程
AnimateDiff 安装教程
完整讲解 AnimateDiff 在 ComfyUI 中的安装流程，包含节点安装、motion module 放置、基础动图工作流测试和常见依赖错误排查。
先跑通什么
先安装节点、放好 motion module，用低尺寸和短帧数跑通一次。
先确认风险
AnimateDiff 比静态图更依赖插件版本、motion module 和显存。第一次不要追求长视频，先确认最小工作流能稳定输出。
适合谁
- 已经能用 ComfyUI 生成静态图。
- 准备安装 AnimateDiff 生成动图或短视频。
- 需要先排除版本、模型目录和显存问题。
准备条件
- ComfyUI 已能生成静态图。
- 显存建议 8GB 以上。
- Manager 可用。
- 第一次测试只追求跑通，不追求画质。
先用短帧数、小尺寸测试，再提高分辨率或延长视频。不要一开始就把帧数和分辨率拉满。
操作步骤
- 通过 Manager 安装 AnimateDiff 相关节点包。
- 下载对应版本的 motion module，并确认和节点说明匹配。
- 按插件说明把 motion module 放到指定模型目录。
- 重启 ComfyUI，不要只刷新页面。
- 先使用低帧数、低分辨率示例工作流，例如 512×512、8-16 帧。
- 确认能输出 gif、webp 或视频帧序列。
- 跑通后再一点点加帧数、加分辨率，而不是反过来。
常见卡点
- 节点版本和 motion module 版本不匹配。
- 首次测试就用 48 帧或 1024 分辨率。
- 视频合成依赖没装全。
- 以为静态图能跑就等于视频也能跑。
失败时先看什么
- 红色节点：先补自定义节点。
- motion module 报错：核对版本和放置目录。
- 生成中断：先降分辨率、帧数和 batch。
- 更新后才坏：优先检查插件版本兼容性。
不要这样做
- 一上来跑 1024 分辨率和 48 帧。
- 混用不匹配的节点版本和 motion module。
- 首次测试同时叠加 ControlNet、IPAdapter 和多 LoRA。
验证是否成功
- 短帧数工作流能完成。
- 输出有连续帧且动作变化正常。
- 控制台不再报 motion module 或 video 合成依赖错误。
- 能稳定跑通一遍后再提质量。
如果仍然失败
保存控制台里从 Traceback 到最后一行的完整报错，并记录 ComfyUI 版本、显卡型号、显存容量、motion module 文件名和最近安装的插件。网页上的红色提示通常不够定位问题。
下一步推荐
- 新手路线：/topics/comfyui-beginner/
- 报错排查：/topics/comfyui-errors/
- 模型基础：/topics/model-basics/
- 插件安装：/topics/must-have-plugins/
更新记录
- 2026-05-12：扩写为正式教程，补充操作步骤、常见错误和验证清单。