ComfyUI-WanVideoWrapper 完整教程三步跑通 WanVideo 文本转视频、图像转视频与口型同步【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper这是一份可以直接照做的 ComfyUI-WanVideoWrapper 教程覆盖把 WanVideo 系列视频大模型接入 ComfyUI 的完整流程环境准备、加载示例工作流、显存优化与报错排查。ComfyUI-WanVideoWrapper 是 ComfyUI 的一个自定义节点扩展核心能力有三项——文本转视频T2V、图像转视频I2V、音频驱动口型同步HuMo。它同时把 ATI、ReCamMaster、HuMo 等新发布的玩法以及 SkyReels、FantasyPortrait、MoCha 等第三方模型生态都打包成了现成节点。刚接触 ComfyUI 想生成视频的新手和想第一时间尝鲜新视频模型的老玩家都能从这里起步。能生成什么三类效果预览与示例工作流清单先列出能产出的内容和对应要加载的文件目标清晰后再动手装环境。所有示例都放在 示例工作流目录 里把 json 文件拖进 ComfyUI 画布即可加载无需从零搭建。文本转视频T2V一段文字描述直接生成视频示例为wanvideo_2_1_14B_T2V_example_03.json图像转视频I2V一张静态图变成动态镜头示例为wanvideo_2_1_14B_I2V_example_03.json口型同步人像图加一条音频生成嘴型与声音匹配的说话视频示例为wanvideo_2_1_14B_HuMo_example_01.json下面这张人像图就是图像转视频的典型输入素材项目自带的素材都在 example_inputs 目录 中准备工作环境要求、安装步骤与模型文件放置目录环境要求动手前逐项确认ComfyUI 能正常启动Python3.10以上显存8GB起步4GB 可以跑但比较吃力硬盘预留50GB以上空间存放模型文件克隆插件与安装依赖打开终端进入 ComfyUI 的自定义节点目录并克隆插件cd ComfyUI/custom_nodes git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper然后安装插件依赖pip install -r ComfyUI-WanVideoWrapper/requirements.txtWindows 便携版用户改用内置 Python 安装python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-WanVideoWrapper\requirements.txt模型文件放置目录模型放错目录是找不到文件报错的主要来源下载后对照下表格子放置模型类型存放目录作用文本编码器ComfyUI/models/text_encoders理解文字提示词CLIP VisionComfyUI/models/clip_vision分析输入图片内容主视频模型ComfyUI/models/diffusion_models视频生成核心引擎VAEComfyUI/models/vae视频画面编解码重启 ComfyUI 后在节点面板搜索 WanVideoWrapper 分类能看到节点即代表插件加载成功。上手三连三类场景的输入素材、提示词示例与预期效果文本转视频T2V输入素材纯文字无需图片或音频。提示词示例航拍镜头缓缓掠过霓虹闪烁的城市夜街雨滴落下路面倒影流动。预期效果加载wanvideo_2_1_14B_T2V_example_03.json后点击运行采样与解码由节点链路自动完成画面逐帧生成。图像转视频I2V输入素材一张静态图。项目自带woman.jpg、env.png、thing.png等素材可直接使用。提示词示例镜头缓慢推进人物发丝随风轻动光影缓慢变化。预期效果加载wanvideo_2_1_14B_I2V_example_03.json把图片接入加载节点静态照片变成有呼吸感的动态镜头人像之外物体与环境图同样适用。音频驱动口型同步HuMo输入素材一张人像图 一段音频项目自带woman.wav可直接试。提示词示例简洁的场景描述即可重点在音频驱动。预期效果加载wanvideo_2_1_14B_HuMo_example_01.json插件自动提取语音特征角色开口与声音同步适合虚拟主播与教育视频。跑完三个场景后建议按这个参数区间调试步数20~30、CFG7~12更换种子观察画面差异。显存优化手册块交换、量化模型与径向注意力视频生成对显存的要求很高以下四种手段按需求取用优化手段适用场景用法block swap 块交换低显存机器8GB 显存跑 14B 模型把WanVideoSetBlockSwap节点接入工作流模型按块轮流换入显存不一次性占满FP8 / GGUF 量化模型入门测试、显存紧张换用量化版主视频模型显存占用约降40%画质损失可接受radial attention 径向注意力生成数百帧的长视频接入WanVideoSetRadialAttention节点注意力只关注邻近帧大幅减少计算量运动 / 相机控制精准轨迹、镜头推拉摇移使用 WanMove 运动轨迹或 ReCamMaster 相机控制示例如wanvideo_2_1_14B_WanMove_I2V_example_01.json报错自查三类常见现象与对应解法遇到问题先按下表对号入座多数情况不需要重装报错现象最可能原因解决办法运行时报 CUDA out of memory分辨率、帧数超出显存承受能力按顺序尝试分辨率 720p 降到512p帧数33减到17开启 block swap 并多交换几个 block最后再换 FP8 模型模型加载后提示找不到文件模型放错目录约占九成对照模型文件放置目录表格把模型挪到对应文件夹并确认文件名与节点里填写的路径一致Windows 上 torch.compile 相关报错、首次运行显存飙升旧 Triton 编译缓存残留清理C:\Users用户名.triton与temp\torchinductor_用户名两个目录的缓存后重新运行通常即恢复同样的输入再跑第二遍也常常自行好转快速开始核对清单三步确认跑通装好ComfyUI 正常重启节点面板能搜到 WanVideoWrapper 分类。加载示例从 示例工作流目录 把wanvideo_2_1_14B_I2V_example_03.json等文件拖进画布节点连线完整。跑通步数20~30、CFG7~12点击运行确认视频正常输出。跑通之后的路线也不复杂先动步数、CFG、种子建立手感再把运动与相机控制节点接到现有工作流里组合出多节点流水线想再深一层可对照nodes.py、nodes_model_loading.py等核心源码理解节点注册机制尝试写自己的小节点。现在就重启 ComfyUI把第一个示例工作流拖进画布按下运行——你的第一条 AI 视频已经在进度条那头等着了。核心关键词ComfyUI-WanVideoWrapper 教程长尾关键词ComfyUI-WanVideoWrapper 安装教程、WanVideo 文本转视频工作流、WanVideo 图像转视频示例、ComfyUI 音频驱动口型同步、WanVideo 显存优化 block swap、WanVideo 模型文件放置目录【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
