%20(1).png)
ComfyUI_RH_FramePack 插件保姆级教程
1. 插件简介
插件地址： https://github.com/HM-RunningHub/ComfyUI_RH_FramePack
这个插件是一个超级厉害的图片变视频工具！就像是给你的静态照片施了魔法，让它们动起来。想象一下，你有一张美女照片，通过这个插件，她可以眨眼睛、微笑、做手势，变成一段生动的小视频。
主要功能：
- 把一张图片变成一段视频（就像让照片里的人活过来）
- 可以控制视频的长度（想要几秒就几秒）
- 可以指定开始图片和结束图片（比如从微笑变成大笑）
- 自动适配显卡内存，24GB显卡可以处理更高分辨率
- 操作简单，几乎不需要调参数
能带来什么效果：
- 让静态人物照片动起来，做各种表情和动作
- 制作产品展示视频
- 创建社交媒体内容
- 制作艺术创作视频
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI
- 点击右下角的 "Manager" 按钮
- 在搜索框输入 "FramePack"
- 找到 "ComfyUI_RH_FramePack" 点击安装
- 重启 ComfyUI
方法二：手动安装
- 打开终端或命令提示符
- 进入你的 ComfyUI 安装目录下的
custom_nodes文件夹 - 运行命令：
git clone https://github.com/HM-RunningHub/ComfyUI_RH_FramePack.git - 进入插件文件夹：
cd ComfyUI_RH_FramePack - 安装依赖：
pip install -r requirements.txt - 重启 ComfyUI
模型下载
安装插件后，还需要下载相应的模型文件。插件需要以下模型：
- HunyuanVideo（主要的视频生成模型）
- flux_redux_bfl（图片理解模型）
- FramePackI2V_HY（图片转视频专用模型）
- FramePackF1_HY（F1版本专用模型）
具体下载方法请参考插件的 README 文档。
3. 节点详细解析
3.1 RunningHub FramePack 节点
这是插件的核心节点，就像一个魔法师，能把你的静态图片变成动态视频。
3.1.1 节点功能
这个节点的作用就像是一个"图片动画师"。你给它一张照片，告诉它你想要什么样的动作或表情，它就能生成一段视频，让照片里的人或物体按照你的描述动起来。
3.1.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数类型 | 默认值 | 取值范围 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|---|---|
| ref_image | ref_image | IMAGE | 无 | 任意图片 | 清晰的人物或物体照片 | 这是你要让它动起来的那张照片，就像给动画师一个参考图 | 输入的参考图像，作为视频生成的起始帧 | 上传一张美女自拍照，或者产品图片 |
| prompt | prompt | STRING | 空 | 任意文本 | 描述动作的句子 | 告诉插件你想要照片里的人做什么动作，就像给演员说戏 | 文本提示词，描述期望的视频内容和动作 | "女孩微笑着挥手"、"产品慢慢旋转" |
| total_second_length | total_second_length | INT | 5 | 1-120 | 3-10秒 | 视频有多长，就像设定电影的时长，秒数越多视频越长 | 生成视频的总时长（秒） | 想要3秒的短视频就填3，想要10秒就填10 |
| seed | seed | INT | 3407 | 任意整数 | 随机数或固定数 | 这是一个"随机种子"，就像掷骰子的起始点，相同数字会产生相似结果 | 随机种子，控制生成结果的随机性 | 用同样的图片和描述，相同seed会生成相似视频 |
| steps | steps | INT | 25 | 1-100 | 20-30 | 生成质量的精细度，就像画家画画的笔触次数，越多越精细但越慢 | 扩散模型的采样步数，影响生成质量 | 追求质量用30-50，追求速度用15-25 |
| use_teacache | use_teacache | BOOLEAN | True | True/False | True | 一个加速开关，就像汽车的涡轮增压，开启后生成更快 | 启用TeaCache加速技术，提高生成速度 | 一般保持开启，除非遇到兼容性问题 |
| upscale | upscale | FLOAT | 1.2 | 0.1-2.0 | 1.0-1.5 | 放大倍数，就像放大镜，1.0是原始大小，1.5是放大1.5倍 | 分辨率缩放因子，控制输出视频分辨率 | 想要高清视频用1.2-1.5，显卡内存不够用0.8 |
| end_image | end_image | IMAGE | 无（可选） | 任意图片 | 与开始图片相关的照片 | 结束时的样子，就像动画的最后一帧，可以让人从微笑变成大笑 | 可选的结束帧图像，实现从起始图像到结束图像的过渡 | 开始是闭眼照片，结束是睁眼照片，生成眨眼视频 |
3.1.3 输出说明
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| frames | IMAGE | 生成的视频帧序列，就像一本翻页动画书的每一页 |
| fps | FLOAT | 视频的播放速度（每秒帧数），数字越大播放越快 |
3.2 RunningHub FramePack F1 节点
这是插件的升级版节点，就像从普通版汽车升级到F1赛车，功能更强大，控制更精细。
3.2.1 节点功能
F1版本是增强版的图片转视频工具，提供了更多的控制选项和更好的生成质量。就像专业版的视频制作软件，给你更多的创作自由度。
3.2.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数类型 | 默认值 | 取值范围 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|---|---|
| ref_image | ref_image | IMAGE | 无 | 任意图片 | 清晰的人物或物体照片 | 这是你要让它动起来的那张照片，就像给动画师一个参考图 | 输入的参考图像，作为视频生成的起始帧 | 上传一张美女自拍照，或者产品图片 |
| prompt | prompt | STRING | 空 | 任意文本 | 描述动作的句子 | 告诉插件你想要照片里的人做什么动作，就像给演员说戏 | 文本提示词，描述期望的视频内容和动作 | "女孩微笑着挥手"、"产品慢慢旋转" |
| total_second_length | total_second_length | INT | 5 | 1-120 | 3-10秒 | 视频有多长，就像设定电影的时长，秒数越多视频越长 | 生成视频的总时长（秒） | 想要3秒的短视频就填3，想要10秒就填10 |
| fps | fps | INT | 30 | 1-60 | 24-30 | 视频播放的流畅度，就像电影的帧率，数字越大越流畅 | 视频帧率，每秒显示的帧数 | 电影感用24，流畅感用30，超流畅用60 |
| seed | seed | INT | 3407 | 任意整数 | 随机数或固定数 | 这是一个"随机种子"，就像掷骰子的起始点，相同数字会产生相似结果 | 随机种子，控制生成结果的随机性 | 用同样的图片和描述，相同seed会生成相似视频 |
| steps | steps | INT | 25 | 1-100 | 20-30 | 生成质量的精细度，就像画家画画的笔触次数，越多越精细但越慢 | 扩散模型的采样步数，影响生成质量 | 追求质量用30-50，追求速度用15-25 |
| gs | gs | FLOAT | 10.0 | 1.0-32.0 | 8.0-12.0 | 生成强度控制，就像调节画笔的力度，数字越大效果越明显 | 蒸馏CFG缩放参数，控制生成的引导强度 | 想要明显效果用10-15，想要自然效果用6-8 |
| use_teacache | use_teacache | BOOLEAN | True | True/False | True | 一个加速开关，就像汽车的涡轮增压，开启后生成更快 | 启用TeaCache加速技术，提高生成速度 | 一般保持开启，除非遇到兼容性问题 |
| upscale | upscale | FLOAT | 1.0 | 0.1-2.0 | 1.0-1.5 | 放大倍数，就像放大镜，1.0是原始大小，1.5是放大1.5倍 | 分辨率缩放因子，控制输出视频分辨率 | 想要高清视频用1.2-1.5，显卡内存不够用0.8 |
| n_prompt | n_prompt | STRING | 空（可选） | 任意文本 | 不想要的效果描述 | 告诉插件你不想要什么，就像告诉厨师不要放辣椒 | 负面提示词，描述不希望出现的内容 | "模糊的"、"扭曲的"、"不自然的动作" |
3.2.3 输出说明
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| frames | IMAGE | 生成的视频帧序列，就像一本翻页动画书的每一页 |
| fps | FLOAT | 视频的播放速度（每秒帧数），数字越大播放越快 |
4. 使用技巧和建议
4.1 图片选择技巧
- 清晰度很重要：选择高清、清晰的图片，就像给画家一个好的画布
- 人物居中：如果是人物照片，尽量让人物在画面中央
- 光线充足：避免过暗或过亮的图片
- 背景简洁：复杂背景可能影响生成效果
4.2 提示词编写技巧
- 具体描述：不要只说"动起来"，要说"微笑着挥手"
- 动作简单：复杂动作可能生成效果不好
- 中英文都可以：插件支持中文和英文提示词
- 避免矛盾：不要在一个提示词里要求相互矛盾的动作
4.3 参数调节建议
- 新手设置：steps=25, upscale=1.0, 其他保持默认
- 追求质量：steps=30-40, upscale=1.2-1.5
- 追求速度：steps=15-20, upscale=0.8-1.0
- 显卡内存不足：降低upscale值，缩短视频长度
4.4 常见应用场景
- 人物动画：让照片里的人眨眼、微笑、挥手
- 产品展示：让产品旋转、展示不同角度
- 艺术创作：让画作中的元素动起来
- 社交媒体：制作有趣的动态头像或表情包
5. 常见问题解答
5.1 安装相关问题
Q: 安装后找不到节点怎么办？
A: 重启ComfyUI，如果还是找不到，检查插件是否正确安装在custom_nodes文件夹中。
Q: 提示缺少模型文件怎么办？
A: 按照插件README的说明下载所需的模型文件，放到正确的models文件夹中。
Q: 安装依赖时出错怎么办？
A: 确保你的Python环境正确，可以尝试手动安装requirements.txt中的每个包。
5.2 使用相关问题
Q: 生成的视频很模糊怎么办？
A: 尝试提高steps参数（25-40），使用更清晰的输入图片，适当提高upscale值。
Q: 生成速度很慢怎么办？
A: 确保use_teacache开启，降低steps参数，缩短视频长度，降低upscale值。
Q: 显卡内存不够用怎么办？
A: 降低upscale参数到0.8或更低，缩短视频长度，关闭其他占用显存的程序。
Q: 生成的动作不自然怎么办？
A: 调整提示词，使用更简单的动作描述，尝试不同的seed值。
5.3 效果优化问题
Q: 如何让动作更明显？
A: 在F1版本中提高gs参数值，使用更具体的动作描述。
Q: 如何让视频更流畅？
A: 提高fps参数，增加steps参数，使用质量更好的输入图片。
Q: 如何控制动作幅度？
A: 通过调整提示词的描述强度，使用"轻微地"、"缓慢地"等修饰词。
6. 进阶使用技巧
6.1 工作流搭建
- 可以配合其他ComfyUI节点使用
- 建议在生成后使用视频后处理节点优化效果
- 可以批量处理多张图片
6.2 质量优化
- 使用高质量的输入图片
- 合理设置参数平衡质量和速度
- 可以多次生成选择最佳效果
6.3 创意应用
- 结合不同的提示词创造独特效果
- 使用开始和结束图片创建转场效果
- 可以作为其他视频制作流程的素材来源
7. 总结
ComfyUI_RH_FramePack是一个功能强大且易于使用的图片转视频插件。它就像是给你的静态图片注入了生命力，让它们能够动起来。无论你是想制作有趣的社交媒体内容，还是进行专业的视频创作，这个插件都能为你提供很好的帮助。
记住，好的效果需要：
- 清晰的输入图片
- 合适的提示词描述
- 合理的参数设置
- 足够的耐心和尝试
希望这个教程能帮助你快速上手这个神奇的插件，创作出令人惊艳的动态视频作品！