ComfyUI-WanVideoWrapper 入门指南:从安装到跑通第一段 Wan 视频
2026/9/24 16:09:49 网站建设 项目流程

ComfyUI-WanVideoWrapper 入门指南:从安装到跑通第一段 Wan 视频

【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper

ComfyUI-WanVideoWrapper 是面向 WanVideo(Wan 系列)视频生成模型的 ComfyUI 自定义节点集合,覆盖文生视频、图生视频、LoRA 加载,以及相机、姿态、轨迹等大量控制类玩法。如果你已经在用 ComfyUI,想跑 Wan 系模型却不确定该从哪个节点入手,这篇文章可以带你从安装一路走到第一段视频产出。

它和原生 Wan 支持有什么区别

作者对定位说得比较直白:这不是为了替代 ComfyUI 原生支持,而是把仓库当作"试验田",新模型、新特性先在这里快速验证,不少能力(比如 ATI 节点)比原生更早落地,之后再以 patcher 节点的形式供原生工作流调用。同时这个节点集在显存上做了不少功课:降低了对 torch.compile 的依赖,未合并的 LoRA 权重被改成随 block swap 一起换入换出的 buffer,内存行为更可预期。判断标准可以很简单:原生节点里没有你要的功能,就到这里翻一翻。

安装步骤与模型文件摆放位置

仓库需要放进 ComfyUI 的custom_nodes目录,依赖用 requirements.txt 一键安装:

git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper custom_nodes/ComfyUI-WanVideoWrapper cd custom_nodes/ComfyUI-WanVideoWrapper && pip install -r requirements.txt

如果你用的是 ComfyUI_windows_portable 便携版,改用打包目录里的python_embeded\python.exe执行同样的 pip 命令即可。模型文件按类型放进四个目录:

文件类型目标目录
文本编码器(T5)ComfyUI/models/text_encoders
Clip vision 模型ComfyUI/models/clip_vision
主视频模型(Transformer)ComfyUI/models/diffusion_models
VAE 模型ComfyUI/models/vae

显存吃紧时优先选 fp8 scaled 量化模型;GGUF 量化模型现在也能直接由主模型加载器读取。

第一条工作流由哪些节点串成

一次完整的生成流程,节点分工基本固定:

  • WanVideo Model LoaderWanVideo T5 Text Encoder LoaderWanVideo VAE Loader分别加载主模型、文本编码器和 VAE;
  • 提示词交给WanVideo TextEncode,产出正向与负向文本嵌入;
  • 文生视频用WanVideo Empty Embeds生成空图像嵌入;图生视频则让图片先过WanVideo ClipVision Encode,再进WanVideo ImageToVideo Encode与文本嵌入合并;
  • WanVideo Sampler负责采样步数、CFG、shift、seed 等核心参数;
  • WanVideo Decode把 latent 解码成视频帧输出。

不想从零连线的,example_workflows/ 目录里放着 40 多个可直接导入的 JSON 工作流,覆盖 T2V、I2V、控制类等各种组合,先导入一个文生视频样例跑通,再逐节点对照理解,比死磕连线快得多。

显存不够时的四个降本手段

  • 块换出:通过 WanVideo Set BlockSwap 节点把部分 Transformer 块换到 CPU。官方给出的参考:512x512、81 帧,20/40 块 offload 时占用约 16GB。注意未合并 LoRA 现在会计入块大小,可能要多换两块。
  • 上下文窗口:WanVideo Context Options 支持分窗生成长视频。官方测试中 1025 帧、窗口 81 帧、重叠 16 帧,1.3B T2V 模型占用不到 5GB 显存,在 5090 上约 10 分钟出片。
  • 量化:直接加载 fp8 或 GGUF 模型,等效于把模型本身的占用降下来。
  • 缓存:文本编码支持磁盘缓存,避免同一提示词重复过 T5;cache_methods/ 还提供 TeaCache 一类推理加速缓存。

跑通之后往哪里扩展

可选节点模块在依赖满足时会自动注册,缺失只会警告、不影响其余节点。常用方向包括:

  • 姿态/控制类:controlnet/、uni3c/ 相机控制、SCAIL/ 姿态控制;
  • 运镜与轨迹:recammaster/ 重打镜头、WanMove/ 运动轨迹、skyreels/ 导演控制;
  • 音频与说话人:Ovi/ 图生视频同时产出音频、multitalk/ 与 fantasytalking/ 说话头像、HuMo/;
  • 角色动画:unianimate/、steadydancer/、onetoall/ 等免训练方案。

这套节点集把自己放在"Wan 生态试验田"的位置:先用示例工作流完整跑一遍,再逐个参数做自己的对照实验,是从入门走到进阶最省事的路线。

【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询