# ComfyUI StableAnimator 插件完整教程 ## 1. 插件简介 **原始地址**：https://github.com/HJH-AILab/ComfyUI_StableAnimator ComfyUI StableAnimator 插件是基于 StableAnimator 项目开发的自定义节点集合。这个插件的作用就像是一个"动画制作工厂"，它可以帮你把静态的图片变成会动的视频。 想象一下，你有一张人物照片，这个插件就能让照片里的人做各种动作，比如跳舞、走路、挥手等等。它就像是给静态图片注入了生命力，让原本不动的东西动起来。 **主要功能**： - 把单张图片变成动画视频 - 让图片里的人物做各种动作 - 分析视频中人物的动作姿态 - 制作高质量的人物动画 ## 2. 如何安装 ### 方法一：手动安装 1. 打开你的 ComfyUI 文件夹 2. 进入 `custom_nodes` 文件夹 3. 下载插件文件，放到 `ComfyUI/custom_nodes/ComfyUI_StableAnimator` 文件夹中 4. 下载 StableAnimator 核心文件到 `ComfyUI/custom_nodes/ComfyUI_StableAnimator/StableAnimator` 文件夹 5. 重启 ComfyUI ### 方法二：使用 ComfyUI Manager（推荐） 1. 在 ComfyUI 界面中点击 Manager 2. 搜索 "StableAnimator" 3. 点击安装 4. 重启 ComfyUI ## 3. 节点详细解析 ### 3.1 StableAnimator Model Loader（模型加载器） 这个节点就像是一个"工具箱管理员"，它负责把制作动画需要的所有工具都准备好，放在合适的位置等待使用。 #### 3.1.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 模型路径 | model_path | 文件路径 | 默认路径 | 告诉插件去哪里找制作动画的工具 | 指定StableAnimator模型文件的存储位置 | 选择你下载的模型文件夹路径 | | 设备选择 | device | cpu/cuda | cuda | 选择用电脑的哪个部分来干活 | 选择使用CPU还是GPU进行计算 | 有显卡选cuda，没显卡选cpu | | 精度模式 | precision | fp16/fp32 | fp16 | 选择工作精细程度，影响速度和质量 | 选择浮点数精度，影响内存使用和速度 | 显存小选fp16，显存大选fp32 | ### 3.2 StableAnimator Generator（动画生成器） 这个节点就像是一个"动画导演"，它接收你的图片和动作指令，然后指挥着制作出动画视频。 #### 3.2.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入图片 | input_image | 图片文件 | - | 要变成动画的原始图片 | 作为动画基础的静态图像 | 上传一张人物照片 | | 动作序列 | pose_sequence | 动作数据 | - | 告诉人物要做什么动作 | 包含姿态信息的序列数据 | 连接骨骼动作数据 | | 帧数 | num_frames | 数字 | 25 | 动画有多少张图片组成 | 生成动画的总帧数 | 25帧大约1秒动画 | | 种子值 | seed | 数字 | 随机 | 控制生成结果的随机性 | 随机种子，确保结果可重现 | 固定数字得到相同结果 | | 引导强度 | guidance_scale | 1.0-20.0 | 7.5 | 控制动画跟动作指令的贴合度 | 分类器引导强度，影响生成质量 | 太低动作不准，太高可能僵硬 | | 步数 | num_inference_steps | 数字 | 25 | 制作动画时的精细程度 | 扩散模型的推理步数 | 越多越精细但越慢 | | 宽度 | width | 像素 | 512 | 动画视频的宽度 | 输出视频的像素宽度 | 512适合大多数情况 | | 高度 | height | 像素 | 512 | 动画视频的高度 | 输出视频的像素高度 | 512适合大多数情况 | ### 3.3 Pose Sequence Loader（动作序列加载器） 这个节点就像是一个"动作教练"，它负责读取和准备各种动作数据，告诉人物应该怎么动。 #### 3.3.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 动作文件路径 | pose_path | 文件路径 | - | 动作数据文件的位置 | 包含姿态关键点的文件路径 | 选择.json或.npy格式的动作文件 | | 开始帧 | start_frame | 数字 | 0 | 从第几帧开始读取动作 | 动作序列的起始帧索引 | 0表示从头开始 | | 结束帧 | end_frame | 数字 | -1 | 读取到第几帧结束 | 动作序列的结束帧索引 | -1表示读到最后 | | 帧率调整 | frame_rate | 数字 | 1 | 控制动作播放速度 | 帧率缩放因子 | 2表示快一倍，0.5表示慢一倍 | ### 3.4 Pose Extractor（动作提取器） 这个节点就像是一个"动作分析师"，它能够观察视频，然后记录下人物的每个动作姿态。 #### 3.4.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入视频 | input_video | 视频文件 | - | 要分析动作的视频 | 作为姿态提取源的视频文件 | 上传一个人物跳舞的视频 | | 检测阈值 | detection_threshold | 0.0-1.0 | 0.5 | 动作识别的敏感度 | 姿态检测的置信度阈值 | 0.5适合大多数情况 | | 输出格式 | output_format | json/npy | json | 保存动作数据的格式 | 输出文件的数据格式 | json格式更通用 | | 关键点数量 | num_keypoints | 数字 | 17 | 记录人体多少个关键部位 | 检测的身体关键点数量 | 17个点包含主要关节 | ### 3.5 Video Frame Extractor（视频帧提取器） 这个节点就像是一个"照片裁剪师"，它能把视频拆解成一张张单独的图片。 #### 3.5.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入视频 | input_video | 视频文件 | - | 要拆解的视频文件 | 作为帧提取源的视频 | 上传任意视频文件 | | 输出路径 | output_path | 文件夹路径 | - | 图片保存的位置 | 提取帧的保存目录 | 选择一个空文件夹 | | 帧间隔 | frame_interval | 数字 | 1 | 每几帧提取一张图片 | 帧采样间隔 | 1表示每帧都要，2表示隔一帧取一帧 | | 图片格式 | image_format | jpg/png | jpg | 保存图片的格式 | 输出图像的文件格式 | jpg文件小，png质量高 | ### 3.6 Animation Composer（动画合成器） 这个节点就像是一个"电影剪辑师"，它把一张张图片重新组合成流畅的视频。 #### 3.6.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 图片序列 | image_sequence | 图片列表 | - | 要合成的图片序列 | 按顺序排列的图像帧 | 连接生成的动画帧 | | 输出路径 | output_path | 文件路径 | - | 视频保存的位置 | 合成视频的保存路径 | 选择保存位置和文件名 | | 帧率 | fps | 数字 | 25 | 视频播放速度 | 每秒播放的帧数 | 25fps流畅，15fps省空间 | | 视频格式 | video_format | mp4/avi | mp4 | 保存视频的格式 | 输出视频的编码格式 | mp4兼容性最好 | | 质量 | quality | 1-100 | 80 | 视频画质好坏 | 视频压缩质量 | 80平衡质量和文件大小 | ## 4. 使用技巧和建议 ### 4.1 性能优化建议 - **显存不足时**：选择fp16精度，降低分辨率到512×512 - **速度优化**：减少推理步数到15-20步，使用较小的帧数 - **质量优化**：使用fp32精度，增加推理步数到30-50步 ### 4.2 最佳实践 - **图片准备**：使用清晰的人物正面照，背景简单效果更好 - **动作选择**：选择动作幅度适中的动作序列，避免过于复杂的动作 - **参数调整**：先用默认参数测试，再根据效果微调 ### 4.3 工作流程建议 1. 先用 Pose Extractor 从参考视频中提取动作 2. 使用 Model Loader 加载模型 3. 准备好人物图片 4. 用 Generator 生成动画帧 5. 用 Animation Composer 合成最终视频 ## 5. 常见问题解答 ### 5.1 安装问题 **Q：安装后找不到节点？** A：检查是否重启了ComfyUI，确保文件夹结构正确。 **Q：提示缺少依赖？** A：按照StableAnimator项目的说明安装所需的Python包。 ### 5.2 使用问题 **Q：生成的动画质量差？** A：尝试增加推理步数、使用更高精度、调整引导强度。 **Q：内存不足错误？** A：降低分辨率、使用fp16精度、减少帧数。 **Q：动作不准确？** A：调整引导强度、使用质量更好的动作数据、检查输入图片质量。 ### 5.3 输出问题 **Q：视频播放卡顿？** A：检查帧率设置，确保图片序列完整。 **Q：文件过大？** A：降低视频质量、减少帧数、使用更高压缩比。 ## 6. 进阶使用技巧 ### 6.1 自定义工作流程 你可以组合多个节点创建复杂的动画制作流程： - 使用多个 Pose Extractor 提取不同视频的动作 - 组合多个动作序列创建更长的动画 - 使用不同的人物图片创建角色动画 ### 6.2 批量处理 对于大量图片的批量处理： - 使用相同的动作序列应用到多张图片 - 设置不同的种子值获得变化效果 - 调整参数为批量处理优化性能 ### 6.3 质量控制 - 定期保存中间结果，避免重复计算 - 使用测试用的小参数快速验证效果 - 建立自己的参数预设库 这个插件为ComfyUI带来了强大的动画制作能力，虽然学习曲线稍陡，但掌握后能创作出令人惊艳的动画效果。建议从简单的单人动画开始练习，逐步掌握各个节点的使用方法。
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
