ComfyUI-WanVideoWrapper 快速上手4步装好文生视频与图生视频一次跑通【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapperComfyUI-WanVideoWrapper 是一组针对 WanVideo 视频模型的 ComfyUI 自定义节点一次装好就能覆盖文生视频、图生视频、视频风格迁移、姿态控制、音频驱动和视频超分六类玩法。它适合已经会用 ComfyUI 拉节点、想尽快出片的人如果你刚装好 ComfyUI跟着本文大约 30 分钟能跑出第一段视频。1. 先跑起来30 分钟内拿到第一段视频装 ComfyUI 插件最常见的卡点不是代码而是模型放错目录。这一节先把路铺平硬件够不够、依赖装没装、模型放哪、启动后怎么验证。硬件要求速查什么显卡能跑显卡显存建议配置预期体验8GB1.3B 模型 块交换 FP8 权重480p 短片可出速度慢12GB1.3B 满配或 14B 块交换512x512、81 帧主力档16GB14B 模型20/40 块换出后 512x512x81 约 16GB分辨率和帧数余量更大参考数据1.3B 文生视频模型用 81 帧的上下文窗口显存占用不到 5GB在 5090 上生成 1025 帧约 10 分钟。Windows / macOS / Linux 各一条命令三平台的步骤都是把仓库克隆进 ComfyUI 的custom_nodes目录再装依赖。# Linux / macOS cd /path/to/ComfyUI/custom_nodes git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper pip install -r requirements.txtWindows 用官方绿色版时在ComfyUI_windows_portable目录下执行python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-WanVideoWrapper\requirements.txt 依赖清单很短requirements.txt核心是diffusers0.33.0、accelerate1.2.1、peft0.17.0版本不够会直接导入报错先升这三样。4 类模型文件放哪模型统一放 ComfyUI 的models目录四类对号入座模型目录文本编码器ComfyUI/models/text_encoders视觉编码器ComfyUI/models/clip_vision主视频模型transformerComfyUI/models/diffusion_modelsVAEComfyUI/models/vae作者推荐下载 FP8 缩放版权重同样画质下显存占用明显更低主模型加载节点的量化选项要选对应的_scaled档位选错会直接报错。GGUF 格式的模型也能在主加载节点里直接用。首次启动自检5 项全过才算装好重启 ComfyUI节点搜索框输入WanVideo能列出加载、采样、潜变量等节点控制台无红色导入报错可选模块如 Ovi、Lynx 缺依赖时只警告属正常模型加载节点的下拉里能选中你放进去的权重用仓库自带示例工作流跑一次最小档512x512、81 帧、1.3B 模型能出片输出的视频帧率是 16fps——这是 WanVideo 的默认采样帧率shared_config.py 中sample_fps 16不是你的设置错了。2. 搞懂它这些节点到底在干嘛原理部分只用一个类比就说清楚。把生成一段视频比作开一家餐厅文本编码器是翻译官把你的中文提示词翻成模型听得懂的向量。它本身不出菜但翻译质量决定后厨理解。视频生成器transformer是后厨主厨从纯噪声开始一步步去噪出画面每步都参考翻译官的菜单。这是吃显存的大头40 层注意力块就是主厨的 40 道工序。控制模块是轨道姿态关键点、控制网、相机轨迹等把镜头和动作约束在既定路径上主厨只能在轨道内发挥。后处理单元是出餐前的摆盘VAE 把压缩表示解码成像素FlashVSR 这类超分节点再补细节。记住一条主线就够了噪声进视频出中间每一步由菜单文本 轨道控制约束。其余细节用到时再查对应节点。3. 六大功能逐个拆场景、参数、坑每个功能按适用场景 / 关键参数 / 易踩坑三件套给。文生视频T2V适用场景没有参考图纯靠提示词生成场景片段如环境空镜、氛围短片。关键参数采样步数默认 30、cfg 默认 6.0、shift 默认 5.0、调度器默认 unipcnodes_sampler.py 默认值帧数走 4n1 规则81 帧是常用档。易踩坑提示词里堆太多主体画面会互相打架一句话说清主体 动作 背景更稳。图像转视频I2V适用场景给一张图加运动产品、角色、风景首帧都能用。关键参数首帧对齐靠 clip vision 编码注意加载图与目标分辨率同比例避免拉伸变形。易踩坑输入图里有大面积纯白背景时运动容易糊边先裁紧主体。视频风格迁移V2V适用场景已有视频换画风/换质感比整段重生成便宜得多。关键参数从干净视频起步时打开add_noise_to_samplesdenoise_strength 控制改动的幅度1.0 是完全重绘。易踩坑denoise 低于 0.6 时风格几乎没变化别误以为节点没生效。音频驱动适用场景让画面跟着音频动对口型、数字人播报。关键参数走 MultiTalk、HuMo、FantasyTalking 等节点组各带自己的音频编码器。易踩坑音频采样率不匹配会静默失真先用pyloudnorm依赖已含归一化响度。视频超分适用场景低分辨率结果补细节先出 480p 再超分是省显存的常见路线。关键参数FlashVSR 解码器加载后串在 VAE 解码环节FlashVSR/flashvsr_nodes.py。易踩坑超分前就堆高 CFG会放大纹理噪点先定画面再放大。姿态控制适用场景指定人物动作轨迹做舞蹈、运动镜头。关键参数SCAIL、SteadyDancer、MTV 等节点组各自吃骨骼序列WanMove 吃轨迹点云。易踩坑姿态序列和帧数对不上时按 4n1 补帧别裁掉原视频节奏。4. 做出来两个可复现案例案例 1玩具 360° 展示视频——一次翻车后的调整第一次跑 720x720、121 帧结果主体转体时耳朵和花茎糊成一片。问题不在模型在两处参数帧数降回 815 秒 16fps帧数越多运动一致性越难保产品展示 5 秒足够121 帧纯属给自己加难度CFG 从 8 降到 6.0高引导强度放大了背景噪点旋转中花瓣边缘开始闪烁回到默认 6.0 后闪烁消失。调整后同一套 512x512→超分 720p 的流程出片干净。产品类画面记住一条低 CFG 中等步数30 后期超分比一步到位的高分辨率更稳。案例 25 秒人物肖像视频——参数为什么这么设参数照抄这组每个值都有来由参数取值为什么分辨率512x512VAE 压缩步长 (4,8,8)512 能被 8 整除无补边损失帧数815 秒4n1 规则 16fps正好 5 秒步数30默认值表情类小幅度运动不需要 50 步CFG6.0提示词只描述一个表情变化高 CFG 会过饱和调度器unipc默认调度器小幅度运动下最不容易跳帧表情变化幅度不满意时先动提示词里的动作描述其次才动 cfg——步数在这个量级里收益很小。5. 调优与避坑显存、速度、质量三角三者只能同时占两个你的选择顺序应该是先保显存不爆再挑速度质量最后补。显存不够优先换 FP8 缩放权重其次开块交换blocks_to_swap每加 2 块约多换出 0.5GB 量级最后才降分辨率。LoRA 不参与合并时也会占显存显存紧张就把 LoRA 合并进模型。速度不够开 Teacache阈值 0.25–0.30 是作者给出的可用区间阈值越激进跳步越多早期跳步容易毁掉运动可以让起始步晚一点。质量不够步数从 30 往上调收益有限先检查 CFG 和提示词纹理细节交给超分节点别用分辨率硬扛。 Windows 用户遇到第一次跑新分辨率显存暴涨、第二次又正常是 Triton 编译缓存的已知问题删掉C:\Users\用户名\.triton和AppData\Local\Temp\torchinductor_用户名两个目录再跑。故障速查表现象先查这里加载报量化档位不匹配权重是 scaled 版却选了非 scaled 档位或反之两者必须一一对应块交换与 VRAM 管理同时开二者互斥只能启用其中一个首帧变形、主体漂移输入图比例与目标分辨率不一致先 resize 再进 I2V运动抽搐、跳帧Teacache 阈值过低或起始步太早阈值提到 0.30 并推迟 start step面部崩坏换更高质量首帧、降分辨率重试姿态类工作流检查关键点序列长度出片帧率看着快16fps 是模型默认采样帧率导出时再倍速不是节点 bug节点功能还在持续扩充新模型支持以仓库更新为准。现在就重启 ComfyUI把 1.3B 模型的最小档工作流跑一遍。出片后对照第 5 节的三角表调一次显存档位。你的第一段视频30 分钟就能有。【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考