AnimateDiff是目前ComfyUI生态中生成动态视频最流行的方案之一。它的核心思路是在Stable Diffusion的生图流程中插入一个运动模块，让原本只能输出静态图的模型具备帧间连续运动的能力。很多新手在第一次接触时，会被节点安装、运动模块放置路径、版本选择这些问题卡住。本文就把整个流程拆开讲清楚，从节点组安装到运动模块加载，再到常见报错的处理，帮你跑通第一条视频生成工作流。
一、AnimateDiff节点组的两种安装方式
AnimateDiff在ComfyUI中并不是自带功能，需要安装第三方节点包才能使用。安装方式主要有两种，第一种是通过ComfyUI Manager管理器安装，第二种是手动下载放入节点目录。两种方式最终效果一样，推荐新手优先使用Manager方式。
使用Manager安装时，先打开ComfyUI界面，点击右侧的Manager按钮，在弹出面板中选择Manage Custom Nodes，然后在列表中搜索AnimateDiff，通常选择带有Elegant字样的comfyui-animatediff-evolved项目，这是目前维护最活跃、功能最完善的版本。点击Install后等待安装完成，再点击Restart重启ComfyUI即可。
如果网络环境不好或者没有安装Manager，可以采用手动方式。先在GitHub上找到项目仓库，点击Code按钮选择Download ZIP，下载完成后解压，把解压出的文件夹整体复制到ComfyUI安装目录下的custom_nodes文件夹内。注意路径要找对，比如你的ComfyUI装在D盘，完整路径就是D:\ComfyUI\custom_nodes\。放好后同样需要重启ComfyUI，重启后在节点列表里搜索AnimateDiff，能看到AnimateDiff Loader等相关节点就说明安装成功了。
二、运动模块的下载与文件放置
节点组装好之后，还差一个关键的东西：运动模块。AnimateDiff的原理是在SD模型的网络结构中插入额外的时序注意力层，这些层的权重就存放在运动模块文件里。没有它，Loader节点会直接报错或者生成完全静止的画面。
运动模块文件通常以mm开头的safetensors格式发布，比如mm_sd_v15_v2.ckpt、mm_sd_v15_v3.safetensors等。下载后需要放到ComfyUI安装目录下的models文件夹，具体路径是models\animatediff_models\，如果目录不存在就手动创建一个。这里要注意，不同版本的AnimateDiff节点包对目录命名可能略有差异，有的旧版本使用animatediff-models这种带横线的写法，遇到加载不到文件的情况时可以先检查目录名是否匹配。
版本选择上建议直接使用v3版本，它在运动连贯性和画面质量上相比v2都有明显提升，而且向下兼容性更好。此外还有针对SD1.5的HotshotXL和SDXL专用运动模块，如果你的底模型是SDXL，就不能使用SD1.5的模块，两者网络结构不同，混用会直接报错。文件体积方面，SD1.5的运动模块一般在1.7GB左右，下载前确保磁盘空间充足。
三、在ComfyUI中加载运动模块并搭建工作流
文件都到位后，开始搭建工作流。核心节点是AnimateDiff Loader，把它添加到画布上，在model_name下拉框中选择刚才放入的运动模块文件。如果下拉框是空的，说明路径不对或者忘记重启，回头检查一下文件位置。
工作流连接顺序参考： Checkpoint加载器 → AnimateDiff Loader → CLIP文本编码 AnimateDiff Loader → K采样器 → VAE解码 → 保存 AnimateDiff Loader 额外输出 context_options
连接方式很简单，把Checkpoint模型加载器的MODEL输出接到AnimateDiff Loader的输入上，Loader的MODEL输出再接到K采样器，相当于把运动模块串联在底模型和采样器之间。K采样器的其他连接和普通文生图工作流完全一致，正向和负向提示词接CLIP文本编码，输出接VAE解码后保存。
视频长度和帧数由AnimateDiff Loader里的参数控制。frame_rate设置帧率，一般填8或者16；length设置生成的总帧数，常见的16帧对应2秒左右的短视频。beta_schedule建议选择sqrt_linear或autoselect，它会影响采样噪声调度，对画面稳定性影响较大。context_length参数在生成较长视频时用于滑窗处理，16帧以内的短片保持默认即可。
四、常见问题排查与参数优化建议
第一个常见问题是找不到模型文件。表现是Loader节点下拉框为空或者报错提示file not found，解决办法是核对文件是否放在models\animatediff_models目录下，并且确认文件后缀完整。有时浏览器下载会把文件名改乱，重命名回原始文件名即可。
第二个问题是显存溢出。生成视频比生成图片消耗显存大得多，因为每一帧都要参与完整的采样计算。如果显存在8GB左右，建议把帧数控制在16帧、分辨率降到512左右，并且在Loader中开启Latent Space Batch的优化选项。显存更小的环境可以考虑使用v2精简版运动模块，体积和占用都会低一些。
参数方面还有几个实用技巧。采样步数保持在20到25步即可，步数过高对视频质量提升有限但耗时成倍增加。CFG值建议在7到8之间，过高容易导致帧间闪烁。生成完成后保存的是GIF或图片序列，想要MP4格式可以在后面串联Video Combine节点，在format参数中选择video-h264-mp4，同时指定帧率，输出的就是可以直接播放的视频文件。掌握这些要点后，配合不同的提示词和ControlNet，还能进一步做出人物动作、镜头运动等更复杂的效果。
ComfyUIAnimateDiff视频生成修改时间：2026-08-31 08:40:29