%20(1).png)
ComfyUI-MuseV 插件完全教程
1. 插件简介
插件地址： https://github.com/chaojie/ComfyUI-MuseV
ComfyUI-MuseV 是一个超级强大的视频生成插件，就像给你的 ComfyUI 装了一个"魔法视频工厂"。这个插件基于 MuseV 模型，能帮你做两件特别厉害的事情：
- 文字转视频 - 输入一张图片和一段描述文字，就能生成一段动态视频，就像把静态照片变成会动的电影
- 视频转视频 - 输入一个参考图片和一个动作视频（比如姿势序列），就能让参考图片里的人物按照动作视频的动作来表演
这个插件最大的特色是：
- 能生成高质量的人物动画视频
- 支持面部表情和身体动作的精确控制
- 可以让静态人物照片"活"起来
- 支持多种风格和场景的视频生成
想象一下，你有一张美女照片，通过这个插件，你可以让她眨眼、微笑、点头，甚至跳舞！
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI，点击右侧的 "Manager" 按钮
- 在搜索框里输入 "MuseV"
- 找到插件后点击 "Install" 安装
- 重启 ComfyUI 服务器
- 刷新网页界面
方法二：手动下载安装
- 打开终端/命令行
- 进入 ComfyUI 的 custom_nodes 文件夹
- 运行命令：
git clone https://github.com/chaojie/ComfyUI-MuseV.git - 重启 ComfyUI
下载必要的模型文件
安装插件后，还需要下载 MuseV 的模型文件：
huggingface-cli download --resume-download TMElyralab/MuseV --local-dir ComfyUI/models/diffusers/TMElyralab/MuseV
3. 节点详细解析
3.1 MuseVRun（文字转视频节点）
这个节点就像一个"静态图片动画师"，能把一张静态图片变成一段动态视频。你给它一张照片和一段描述，它就能让照片里的人物动起来。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| ref_image | ref_image | 图片数据 | 连接图片输入节点 | 要变成动画的参考图片 | 输入用于生成视频的参考图像 | 连接一张美女照片，让她在视频中动起来 |
| prompt | prompt | 文本字符串 | 描述动作的文字 | 描述你想要的动作效果 | 描述视频中期望的动作和场景 | 输入"眨眼睛，微笑，点头"让人物做这些动作 |
| img_edge_ratio | img_edge_ratio | 浮点数 | 1.0 | 图片边缘比例调整 | 控制输入图像的边缘处理比例 | 设为1.0保持原始比例，0.8会稍微裁剪边缘 |
| video_len | video_len | 整数 | 12 | 生成视频的长度（帧数） | 设置生成视频的帧数长度 | 设为12生成12帧的短视频，24生成更长的视频 |
| seed | seed | 整数 | 1234 | 随机种子数字 | 控制随机性的种子值 | 用相同数字能生成相同效果，换数字得到不同结果 |
| width | width | 整数 | 563 | 视频宽度（像素） | 设置生成视频的宽度 | 563像素宽度，可以改成512、768等 |
| height | height | 整数 | 714 | 视频高度（像素） | 设置生成视频的高度 | 714像素高度，可以改成512、768等 |
| first_redraw_steps | first_redraw_steps | 整数 | 30 | 首帧重绘步数 | 第一帧图像重绘的迭代步数 | 30步能得到较好质量，50步质量更高但更慢 |
| video_steps | video_steps | 整数 | 10 | 视频生成步数 | 视频生成过程的迭代步数 | 10步速度快，20步质量更好 |
| first_redraw_guidance_scale | first_redraw_guidance_scale | 浮点数 | 7.5 | 首帧重绘引导强度 | 控制第一帧重绘时对提示词的遵循程度 | 7.5是平衡值，更高更严格遵循提示词 |
| video_guidance_scale | video_guidance_scale | 浮点数 | 3.5 | 视频生成引导强度 | 控制视频生成时对提示词的遵循程度 | 3.5适中，太高可能导致视频不自然 |
| sd_model_name | sd_model_name | 选择列表 | majicmixRealv6Fp16 | 使用的基础模型 | 选择用于生成的Stable Diffusion模型 | majicmixRealv6Fp16适合真实人物，fantasticmix_v10适合动漫风格 |
| uselcm | uselcm | 布尔值 | False | 是否使用LCM加速 | 是否启用LCM（潜在一致性模型）加速生成 | True能大幅提速但可能影响质量，False质量更好 |
3.2 MuseVRunVid2Vid（视频转视频节点）
这个节点就像一个"动作复制师"，能让参考图片里的人物模仿另一个视频里的动作。比如你有一张静态照片和一段跳舞视频，它能让照片里的人按照视频里的动作跳舞。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| ref_image | ref_image | 图片数据 | 连接图片输入节点 | 要变成动画的参考图片 | 输入用于生成视频的参考图像 | 连接一张人物照片，让他模仿动作 |
| prompt | prompt | 文本字符串 | 描述动作的文字 | 描述你想要的动作效果 | 描述视频中期望的动作和场景 | 输入"优雅地跳舞，面带微笑" |
| video_path | video_path | 文件路径 | 动作视频文件路径 | 提供动作参考的视频文件 | 输入包含动作序列的视频文件路径 | 输入一个跳舞视频的路径，让参考人物模仿跳舞 |
| img_edge_ratio | img_edge_ratio | 浮点数 | 1.0 | 图片边缘比例调整 | 控制输入图像的边缘处理比例 | 设为1.0保持原始比例，0.8会稍微裁剪边缘 |
| video_len | video_len | 整数 | 12 | 生成视频的长度（帧数） | 设置生成视频的帧数长度 | 设为12生成12帧的短视频，24生成更长的视频 |
| seed | seed | 整数 | 1234 | 随机种子数字 | 控制随机性的种子值 | 用相同数字能生成相同效果，换数字得到不同结果 |
| width | width | 整数 | 563 | 视频宽度（像素） | 设置生成视频的宽度 | 563像素宽度，可以改成512、768等 |
| height | height | 整数 | 714 | 视频高度（像素） | 设置生成视频的高度 | 714像素高度，可以改成512、768等 |
| first_redraw_steps | first_redraw_steps | 整数 | 30 | 首帧重绘步数 | 第一帧图像重绘的迭代步数 | 30步能得到较好质量，50步质量更高但更慢 |
| video_steps | video_steps | 整数 | 10 | 视频生成步数 | 视频生成过程的迭代步数 | 10步速度快，20步质量更好 |
| first_redraw_guidance_scale | first_redraw_guidance_scale | 浮点数 | 7.5 | 首帧重绘引导强度 | 控制第一帧重绘时对提示词的遵循程度 | 7.5是平衡值，更高更严格遵循提示词 |
| video_guidance_scale | video_guidance_scale | 浮点数 | 3.5 | 视频生成引导强度 | 控制视频生成时对提示词的遵循程度 | 3.5适中，太高可能导致视频不自然 |
| sd_model_name | sd_model_name | 选择列表 | majicmixRealv6Fp16 | 使用的基础模型 | 选择用于生成的Stable Diffusion模型 | majicmixRealv6Fp16适合真实人物，fantasticmix_v10适合动漫风格 |
| uselcm | uselcm | 布尔值 | False | 是否使用LCM加速 | 是否启用LCM（潜在一致性模型）加速生成 | True能大幅提速但可能影响质量，False质量更好 |
3.3 VHS_FILENAMES_STRING_MuseV（文件名转换节点）
这个节点就像一个"文件名提取器"，专门用来从视频文件列表中提取出文件名字符串，方便其他节点使用。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| filenames | filenames | VHS文件名列表 | 连接VHS节点输出 | 视频文件名列表 | 接收VHS格式的文件名列表数据 | 连接VideoHelperSuite的输出，获取视频文件名 |
4. 使用技巧和建议
4.1 文字转视频的最佳实践
- 选择合适的参考图片 - 人物清晰、表情自然的照片效果最好
- 写好提示词 - 描述具体的动作，比如"眨眼、微笑、轻微点头"
- 调整视频长度 - 新手建议从12帧开始，熟练后可以尝试24帧或更长
- 合理设置尺寸 - 建议使用512x512或768x768这样的标准尺寸
4.2 视频转视频的技巧
- 准备动作视频 - 动作清晰、背景简单的视频效果更好
- 匹配人物姿势 - 参考图片的人物姿势最好与动作视频的起始姿势相似
- 控制视频长度 - 动作视频不要太长，12-24帧比较合适
- 调整引导强度 - video_guidance_scale太高会导致动作不自然
4.3 参数调优建议
- 质量优先设置 - first_redraw_steps=50, video_steps=20, uselcm=False
- 速度优先设置 - first_redraw_steps=20, video_steps=10, uselcm=True
- 平衡设置 - first_redraw_steps=30, video_steps=15, uselcm=False
5. 常见问题解答
Q1: 为什么生成的视频人物动作很僵硬？
A: 可能是video_guidance_scale设置太高了，试试降低到2.0-3.0之间。另外检查提示词是否过于复杂。
Q2: 生成速度太慢怎么办？
A: 可以开启uselcm=True，或者减少first_redraw_steps和video_steps的数值。
Q3: 为什么生成的视频质量不好？
A: 检查参考图片质量，确保人物清晰。增加生成步数，关闭LCM加速。
Q4: 视频转视频时人物变形严重？
A: 确保参考图片和动作视频的人物姿势相似，调低video_guidance_scale值。
Q5: 提示找不到模型文件？
A: 确保已经下载了MuseV模型文件到正确的目录：ComfyUI/models/diffusers/TMElyralab/MuseV
6. 高级功能
6.1 模型选择
- majicmixRealv6Fp16 - 适合生成真实风格的人物视频
- fantasticmix_v10 - 适合生成动漫风格的人物视频
6.2 LCM加速
LCM（潜在一致性模型）可以大幅提升生成速度，但可能会影响质量：
- 开启LCM：生成速度提升3-5倍，适合快速预览
- 关闭LCM：质量更高，适合最终输出
6.3 视频长度控制
- 短视频（12帧）：适合简单动作，如眨眼、微笑
- 中等视频（24帧）：适合复杂动作，如点头、转身
- 长视频（48帧+）：适合连续动作，如跳舞、走路
7. 工作流示例
7.1 基础文字转视频工作流
- 加载一张人物图片
- 连接到MuseVRun节点的ref_image
- 设置prompt为"beautiful girl, eye blinks, head wave"
- 调整参数：video_len=12, width=512, height=512
- 运行生成视频
7.2 视频转视频工作流
- 准备参考人物图片和动作视频
- 连接图片到MuseVRunVid2Vid节点
- 设置video_path为动作视频路径
- 设置prompt描述期望效果
- 运行生成新视频
8. 总结
ComfyUI-MuseV 是一个功能强大的视频生成插件，它让静态图片"活"起来变得非常简单。通过3个专门设计的节点，你可以轻松地：
- 让照片里的人物动起来
- 让人物模仿特定的动作
- 生成高质量的人物动画视频
无论你是想制作有趣的动画头像，还是想创作专业的视频内容，这个插件都能满足你的需求。记住，熟练使用需要一些练习，建议从简单的眨眼、微笑动作开始，逐步尝试更复杂的动作效果。
希望这个教程能帮助你更好地使用 ComfyUI-MuseV 插件！如果遇到问题，可以查看插件的 GitHub 页面或者在社区寻求帮助。