%20(1).png)
ComfyUI VIDU 视频生成插件完全指南
1. 插件简介
ComfyUI VIDU 视频生成插件（GitHub地址：https://github.com/1zhangyy1/comfyui-vidu-nodes）是一个专门用来生成视频的神奇工具包。想象一下，你有一堆魔法盒子，每个盒子都有不同的功能：有的能把你写的文字变成视频，有的能让静态图片动起来，有的能把两张图片之间的变化过程做成视频。这个插件就是这样一套魔法盒子，让你在ComfyUI里轻松制作各种视频内容。
这个插件能给我们带来什么效果：
- 把文字描述变成真实的视频（比如你写"一只猫在跑步"，它就能生成一个猫跑步的视频）
- 让静态图片动起来（比如让一张风景照片里的树叶摇摆、水流动）
- 制作角色视频（上传一个人物照片，让这个人物做各种动作）
- 制作过渡视频（给两张图片，它帮你做出从第一张图变到第二张图的过程）
- 把视频变得更清晰（像给视频加了一个放大镜）
2. 如何安装
安装这个插件就像往你的工具箱里添加新工具一样简单：
- 打开你电脑上的ComfyUI文件夹
- 找到里面的
custom_nodes文件夹（这就是放各种插件的地方） - 在这个文件夹里打开命令行（就像打开一个对话框和电脑说话）
- 输入这行神奇的咒语：
git clone https://github.com/1zhangyy1/comfyui-vidu-nodes - 等待下载完成，重启ComfyUI
特别重要的准备工作：
你需要先去VIDU官方那里申请一个"通行证"（叫做API Token），就像办图书证一样。有了这个通行证，你才能使用这些视频生成功能。
3. 节点逐一解析
3.1 Text to Video（文字变视频节点）
这个节点就像一个魔法师，你告诉它一句话，它就能变出一个视频来。比如你说"一只小狗在公园里玩球"，它就能生成一个小狗玩球的视频。
3.2 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本描述 | prompt | 文本 | 具体生动的描述 | 这就是你想要的视频内容，像给画家下订单 | 用于指导视频生成的文本提示词 | 写"一只橙色的猫在厨房里喝牛奶"比写"猫"要好 |
| 视频时长 | duration | 4或8 | 4 | 视频有多长，就像选择歌曲长度 | 生成视频的持续时间，单位为秒 | 新手建议选4秒，生成更快 |
| 通行证 | token | 字符串 | 你的API密钥 | 这是你的身份证，证明你有权限使用 | VIDU API的访问令牌 | 填入你从VIDU官方获得的Token |
| 风格选择 | style | general/anime | general | 选择视频风格，像选择滤镜 | 视频生成的艺术风格 | general是真实风格，anime是动漫风格 |
| 模型选择 | model | vidu-high-performance | vidu-high-performance | 选择生成视频的"引擎"，像选择画笔 | 用于生成视频的AI模型 | 默认的就很好用，不用改 |
| 随机种子 | seed | 数字 | 随机或固定值 | 这是"运气值"，同样描述用不同种子会得到不同结果 | 控制随机性的数值 | 想要同样效果就用相同数字，想要新效果就换数字 |
| 提示词增强 | enhance | true/false | true | 开启后系统会自动优化你的描述，让视频更好看 | 是否启用AI提示词优化 | 建议开启，就像有个助手帮你润色文案 |
| 内容审核 | moderation | true/false | false | 开启后会检查内容是否合适，像内容过滤器 | 是否启用内容审核机制 | 一般情况下关闭即可 |
| 反向提示词 | negative_prompt | 文本 | 可选 | 告诉系统你不想要什么，像购物时的排除条件 | 用于排除不需要元素的负面提示词 | 比如写"模糊，低质量"来避免生成模糊视频 |
3.3 Image to Video（图片变视频节点）
这个节点就像一个魔法棒，能让你的静态图片活起来。你给它一张照片，它就能让照片里的东西动起来，就像哈利波特里的魔法照片一样。
3.4 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | 图片文件 | JPG/PNG格式 | 这是你要让它动起来的图片，像给动画师一张原画 | 用作视频生成基础的静态图像 | 上传一张风景照，让里面的云朵飘动 |
| 文本描述 | prompt | 文本 | 描述动作的文字 | 告诉系统你希望图片里的什么东西怎么动 | 描述期望动作的文本提示词 | 对着人物照片写"微笑并挥手" |
| 视频时长 | duration | 4或8 | 4 | 视频播放多长时间，像设置闹钟 | 生成视频的时长 | 4秒对新手更友好 |
| 通行证 | token | 字符串 | 你的API密钥 | 你的使用权限证明 | VIDU API访问令牌 | 必须填写正确的Token |
| 模型选择 | model | 模型名称 | 默认模型 | 选择处理图片的"大脑"，不同大脑有不同特长 | 选择的AI生成模型 | 用默认的就行，除非有特殊需求 |
| 提示词增强 | enhance | true/false | true | 让系统帮你优化描述，就像有个文案高手帮忙 | 是否启用提示词优化 | 开启能让效果更好 |
| 内容审核 | moderation | true/false | false | 检查生成内容是否合适 | 内容安全检查 | 一般关闭即可 |
| 随机种子 | seed | 数字 | 随机 | 控制生成结果的随机性 | 随机数生成种子 | 想要重现同样效果就用相同数字 |
3.5 Character to Video（角色变视频节点）
这个节点专门用来让人物动起来，就像给照片里的人施了魔法，让他们可以做各种动作。特别适合制作人物动画。
3.6 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 角色图像 | character_image | 图片文件 | 清晰人物照片 | 这是你要让其动起来的人物照片，像请演员拍戏 | 用于生成视频的角色参考图像 | 上传一张清晰的人物正面照 |
| 文本描述 | prompt | 文本 | 动作描述 | 告诉角色要做什么动作，像导演给演员讲戏 | 描述角色动作的文本提示 | 写"转头微笑并点头" |
| 视频时长 | duration | 4或8 | 4 | 表演持续时间 | 视频时长设置 | 4秒足够展示一个完整动作 |
| 通行证 | token | 字符串 | 你的API密钥 | 使用权限验证 | API访问令牌 | 必须正确填写 |
| 风格选择 | style | general/anime | general | 选择真实还是动漫风格 | 视频生成风格 | general适合真人照片 |
| 模型选择 | model | 模型名称 | 默认 | 选择生成引擎 | AI模型选择 | 默认模型效果已经很好 |
| 随机种子 | seed | 数字 | 随机 | 控制生成的随机性 | 随机种子值 | 固定数字可重现效果 |
| 提示词增强 | enhance | true/false | true | 自动优化动作描述 | 提示词优化功能 | 建议开启获得更好效果 |
| 内容审核 | moderation | true/false | false | 内容安全检查 | 内容审核开关 | 一般关闭 |
| 反向提示词 | negative_prompt | 文本 | 可选 | 告诉系统不要什么效果 | 负面提示词 | 比如"模糊，变形" |
3.7 Start-End to Video（首尾帧变视频节点）
这个节点就像一个时间魔法师，你给它两张图片（开始和结束），它就能创造出从第一张图片慢慢变到第二张图片的整个过程，就像看到了时间流逝的全过程。
3.8 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 起始帧 | start_frame | 图片文件 | 清晰图片 | 这是变化的起点，像故事的开头 | 动画序列的第一帧图像 | 上传一朵含苞待放的花 |
| 结束帧 | end_frame | 图片文件 | 清晰图片 | 这是变化的终点，像故事的结尾 | 动画序列的最后一帧图像 | 上传同一朵花完全绽放的样子 |
| 文本描述 | prompt | 文本 | 变化过程描述 | 描述你希望看到的变化过程 | 描述转换过程的文本提示 | 写"花朵缓慢绽放" |
| 通行证 | token | 字符串 | 你的API密钥 | 使用权限证明 | API访问令牌 | 必须正确填写 |
| 模型选择 | model | vidu1.5/vidu2.0 | vidu2.0 | 选择处理引擎，像选择不同的魔法师 | 选择的AI生成模型版本 | vidu2.0效果更好但只支持4秒 |
| 分辨率 | resolution | 360p/720p/1080p | 720p | 视频清晰度，像选择电视画质 | 输出视频的分辨率 | 720p平衡了质量和速度 |
| 视频时长 | duration | 4秒 | 4 | 变化过程持续时间 | 视频持续时间 | vidu2.0只支持4秒 |
| 随机种子 | seed | 数字 | 随机 | 控制变化的随机性 | 随机数种子 | 固定数字可重现相同效果 |
| 运动幅度 | movement_amplitude | auto/small/medium/large | auto | 控制变化的剧烈程度，像调节动画的夸张度 | 控制运动变化的强度 | auto让系统自己判断最合适 |
| 回调网址 | callback_url | 网址 | 可选 | 生成完成后通知你的网址，像快递到了发短信 | 任务完成后的回调地址 | 一般用户不需要填写 |
3.9 Video Upscale（视频超分节点）
这个节点就像一个神奇的放大镜，能让你的视频变得更清晰更高清，就像给视频戴上了眼镜一样。
3.10 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 生成物ID | creation_id | 字符串 | 上一步生成的ID | 这是你要放大的视频的"身份证号码" | 标识特定视频生成任务的唯一ID | 从前面节点的输出中获取这个ID |
| 通行证 | token | 字符串 | 你的API密钥 | 使用权限验证 | API访问令牌 | 必须正确填写 |
| 超分模型 | model | stable | stable | 选择放大算法，像选择不同的放大镜 | 用于视频超分的AI模型 | stable模型效果稳定可靠 |
3.11 Video Downloader（视频下载节点）
这个节点就像一个勤劳的搬运工，能把生成好的视频从网上搬到你的电脑里保存起来。
3.12 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 视频网址 | video_url | 网址 | 生成的视频链接 | 这是视频在网上的地址，像网店的商品链接 | 需要下载的视频URL地址 | 从生成节点的输出中获取 |
| 输出路径 | output_path | 文件夹路径 | outputs | 决定视频保存在电脑的哪个文件夹里 | 本地保存的目录路径 | 可以改成你想要的文件夹名 |
4. 使用技巧和建议
4.1 新手入门建议
- 刚开始先用"文字变视频"节点练手，因为最简单
- 视频时长建议选4秒，生成速度快，容易看到效果
- 文字描述要具体，写"一只白色的小猫在绿色草地上玩红色的球"比写"猫玩球"效果好得多
4.2 图片处理技巧
- 上传图片前先检查大小，不能超过50MB（相当于几十张高清照片的大小）
- 图片比例不要太极端，避免特别长或特别宽的图片
- 人物照片最好是正面清晰的，这样角色节点效果更好
4.3 省钱小窍门
- 生成的视频链接只有1小时有效期，记得及时下载
- 先用短时长（4秒）测试效果，满意了再生成长时长版本
- 使用相同的随机种子可以重现相同效果，避免重复生成
4.4 创意组合使用
- 可以先用"文字变视频"生成基础素材，再用"视频超分"提升质量
- 用"图片变视频"让静态海报动起来，制作动态壁纸
- 用"首尾帧变视频"制作产品展示动画，比如从包装到打开的过程
5. 常见问题解答
5.1 为什么我的视频生成失败了？
可能原因：
- 通行证（Token）填错了或过期了
- 网络连接不稳定
- 上传的图片格式不对（只支持JPG、PNG、WebP）
- 图片太大（超过10MB）或尺寸比例不合适
解决方法：
- 检查Token是否正确复制粘贴
- 换个网络环境试试
- 用图片编辑软件调整图片大小和格式
- 查看ComfyUI的控制台，看看具体错误信息
5.2 为什么生成的视频效果不理想？
可能原因：
- 文字描述太简单或不够具体
- 选择的风格不适合你的内容
- 上传的图片质量不够好
解决方法：
- 把描述写得更详细，包括颜色、动作、环境等
- 尝试不同的风格选项
- 使用高质量、清晰的图片作为输入
5.3 视频下载不了怎么办？
可能原因：
- 视频链接已经过期（超过1小时）
- 网络连接问题
- 输出路径设置错误
解决方法：
- 重新生成视频并立即下载
- 检查网络连接
- 确认输出路径存在且有写入权限
5.4 如何查看详细的错误信息？
打开ComfyUI的控制台窗口，所有VIDU节点都会显示详细的工作日志，格式是"[Vidu 节点名称] 消息内容"。如果出现错误，会有详细的错误说明帮助你排查问题。
6. 注意事项与限制
6.1 技术限制
- 目前只能一次生成1个视频，不支持批量生成
- 角色视频功能对图片尺寸有要求，不能小于128x128像素
- 首尾帧生成视频功能要求两张图片的宽高比例相似（在0.8到1.25之间）
6.2 安全提醒
- 保护好你的API Token，不要泄露给别人
- 注意生成内容的版权问题，不要用于商业用途未经授权的素材
- 生成的视频内容要符合法律法规和平台规定
6.3 版本更新
这个插件现在使用VIDU API v2版本，相比老版本有很多改进：
- 新增了首尾帧生成视频功能
- 支持更多图片格式
- 错误处理更完善，有详细的日志记录
7. 总结
ComfyUI VIDU插件就像一个视频制作的瑞士军刀，每个节点都有自己的特殊功能。掌握了这些节点，你就能轻松制作出各种有趣的视频内容。记住，熟能生巧，多试试不同的参数组合，你会发现更多有趣的玩法！
如果在使用过程中遇到问题，可以：
- 查看ComfyUI控制台的详细日志
- 到GitHub项目页面提交问题
- 联系VIDU官方客服
现在就开始你的视频创作之旅吧！