ComfyUI-PainterI2V 此节点由抖音博主：绘画小子 制作。

Wan2.2 图生视频增强节点，专门针对4步LoRA（如 lightx2v）的慢动作问题进行优化。

2026-2-13 我制作了一个PainterHumoAI2V节点，已经实现WAN2.2+Humo 直接 音频+图片 4步生成音频驱动的图生视频（AI2V）并支持首尾帧，欢迎尝试（项目内有工作流）！https://github.com/princepainter/ComfyUI-PainterNodes

2025-12-30，我更新了一个PainterI2V的优化版PainterI2Vadvanced，建议尝试使用。项目地址：https://github.com/princepainter/ComfyUI-PainterI2Vadvanced

如果你用的是KJ的wan2.2-i2v工作流，请使用这个专门为KJ开发的节点，效果一致 (https://github.com/princepainter/ComfyUI-PainterI2VforKJ)

（FirstLastFrameToVideo）首尾帧节点 PainterFLF2V：https://github.com/princepainter/Comfyui-PainterFLF2V

🛠 解决的问题

• ✅ 1.减少慢动作：提升运动幅度 15-50%
• ✅ 2.增强运镜：让运镜提示词更听话，运镜幅度更大

和wan2.2官方节点效果对比

motion_amplitude=1.2	motion_amplitude=1.15	motion_amplitude=1.15
motion_amplitude=1.5	motion_amplitude=1.2	motion_amplitude=1.15

以上视频对比效果，我是使用wan2.2官方模型+light2v 4步i2v lora V1.0做的测试（见下图），其他模型使用效果有待各位自行测试

节点特点

• 单帧输入优化：专为wan2.2单帧图生视频设计
• 即插即用：完全兼容原版 Wan2.2 工作流

📦 安装

方法 1: ComfyUI Manager（推荐）

1. 打开 ComfyUI Manager
2. 搜索 PainterI2V
3. 点击安装

方法 2: 手动安装

# 进入ComfyUI的custom_nodes目录
cd ComfyUI/custom_nodes

# 克隆仓库
git clone https://github.com/princepainter/ComfyUI-PainterI2V.git

重启ComfyUI

💡 使用方法

替换节点

在工作流中将 WanImageToVideo 替换为 PainterI2V

参数设置

• motion_amplitude: 1.15（推荐起始值）
• 其他参数与原版保持一致

场景参数推荐

运动类型	推荐参数	示例提示词
快速（跑步 / 跳跃）	1.25–1.35	"快速向前奔跑"
正常（走路 / 挥手）	1.10–1.20	"流畅地行走"
动态增强	1.00–1.10	"略微增强动态和运镜"

提示词优化

• 明确描述运动节奏，如 “快速奔跑”、“流畅行走”
• 避免模糊描述如 “移动”、“走动”

🔬 技术细节

参数值	运动提升	亮度变化	适用场景
1.0（原版）	0%	无	和WAN原版节点无区别
1.15（默认）	+15%	无	通用场景
1.3	+30%	无	体育运动
1.5	+50%	无	极限运动

核心算法原理

• 亮度保护的运动缩放：放大运动向量前分离亮度均值
• 零 latent 初始化：严格保持 4 步 LoRA 的时序依赖链
• 参考帧增强：使用 reference_latents 保持主体一致性，不约束运动

⚡ 进阶技巧

• 最佳效果：配合强运动提示词使用
• 运动过快：每次减少 motion_amplitude 0.05
• 仍然偏慢：可适当增大到 1.4

🙏 致谢

• Wan2.2 团队：提供惊人的视频生成模型

• ComfyUI 社区：灵活的节点系统
  🙏如果这个项目对你有帮助，请给颗星 ⭐️ 支持一下！

• ComfyUI-Painterl2V

This node is created by Douyin creator: 绘画小子

PainterI2V node that specifically fixes the slow-motion issue in 4-step LoRAs (e.g., lightx2v).

2025-12-30现在已经推出升级版PainterI2Vadvanced，建议使用。项目地址：https://github.com/princepainter/PainterI2Vadvanced

The comparative effects in the above video are from my test using the official Wan2.2 model + Light2v 4-step I2V LoRA V1.0. The performance of other models awaits your own testing .

If you're using KJ's wan2.2-i2v workflow, use this node specifically developed for KJ — the effect is consistent.https://github.com/princepainter/ComfyUI-PainterI2VforKJ

🛠 Problems Solved

• ✅ Reduces Slow-Motion Drag: Increases motion amplitude by 15-50%
• ✅ Enhance camera movement: Make the camera movement prompts more responsive and increase the movement amplitude.
• ✅ Optimized for Single Frame: Designed specifically for single-frame image-to-video workflows
• ✅ Plug & Play: Fully compatible with original Wan2.2 workflows

📦 Installation

Method 1: ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for PainterI2V
3. Click Install

Method 2: Manual Installation

# Navigate to ComfyUI's custom_nodes directory
cd ComfyUI/custom_nodes

# Clone the repository
git clone https://github.com/princepainter/ComfyUI-PainterI2V.git

💡 Usage Guide

Replace the Node

In your workflow, replace WanImageToVideo with PainterI2V.

Parameter Settings

• motion_amplitude: 1.15 (recommended starting value)
• Keep all other parameters consistent with the original node.

Recommended Parameters by Scene

Motion Type	Recommended Value	Example Prompt
Fast (running / jumping)	1.25–1.35	"Running forward quickly"
Normal (walking / waving)	1.10–1.20	"Walking smoothly"
Motion Enhancement	1.00–1.10	"Slightly enhance motion and camera movement"

Prompt Optimization Tips

• Clearly describe motion rhythm, e.g., “run fast”, “walk smoothly”
• Avoid vague terms like “move” or “walk around”

🔬 Technical Details

Parameter	Motion Boost	Brightness Change	Best For
1.0 (original)	0%	None	No difference from the original WAN node
1.15 (default)	+15%	None	General use
1.3	+30%	None	Sports action
1.5	+50%	None	Extreme motion

Core Algorithm Principles

• Brightness-Protected Motion Scaling: Separates luminance mean before scaling motion vectors
• Zero Latent Initialization: Strictly preserves the temporal dependency chain required by 4-step LoRAs
• Reference Frame Enhancement: Uses reference_latents to maintain subject consistency without constraining motion

⚡ Advanced Tips

• Best results: Use with strong motion-related prompts
• Motion too fast? Reduce motion_amplitude by 0.05 increments
• Still too slow? Try increasing up to 1.4

🙏 Acknowledgements

• Wan2.2 Team: For the amazing video generation model
• ComfyUI Community: For the flexible node system
• Contributors & testers: For helping refine this node

# Restart ComfyUI

ComfyUI-PainterI2V 快速上手指南

ComfyUI-PainterI2V 是专为 Wan2.2 图生视频设计的增强节点，由抖音博主“绘画小子”开发。它重点解决了使用 4 步 LoRA（如 lightx2v）时视频生成慢动作的问题，可提升运动幅度 15%-50%，并增强运镜提示词的响应能力。

环境准备

• 系统要求：Windows / Linux / macOS
• 前置依赖：
  • 已安装并配置好 ComfyUI
  • 已安装 Wan2.2 官方模型及相关工作流
  • 推荐搭配 lightx2v 4-step I2V LoRA V1.0 使用以获得最佳效果
  • Python 环境需支持 Git 命令

安装步骤

方法一：通过 ComfyUI Manager 安装（推荐）

1. 启动 ComfyUI，打开 ComfyUI Manager。
2. 在搜索框中输入 PainterI2V。
3. 找到插件后点击 Install。
4. 安装完成后重启 ComfyUI。

方法二：手动安装

打开终端或命令行工具，执行以下命令：

# 进入 ComfyUI 的 custom_nodes 目录
cd ComfyUI/custom_nodes

# 克隆仓库
git clone https://github.com/princepainter/ComfyUI-PainterI2V.git

💡 国内加速提示：如果 GitHub 连接缓慢，可使用镜像源加速克隆：

git clone https://ghp.ci/https://github.com/princepainter/ComfyUI-PainterI2V.git

克隆完成后，重启 ComfyUI 以加载新节点。

基本使用

1. 替换节点

在现有的 Wan2.2 图生视频工作流中：

• 找到原有的 WanImageToVideo 节点。
• 将其删除或禁用，替换为新安装的 PainterI2V 节点。
• 保持其他连线（图片输入、Prompt、模型加载等）不变。

2. 参数设置

核心参数为 motion_amplitude（运动幅度），其他参数与原版保持一致。

• 推荐起始值：1.15（通用场景，提升约 15% 运动幅度）
• 调整策略：
  • 若运动仍偏慢：逐步增加至 1.25 - 1.35（适合跑步、跳跃）。
  • 若运动过快或失真：每次减少 0.05。

3. 提示词优化建议

为了配合节点效果，建议在 Prompt 中明确描述运动节奏：

• ✅ 推荐："快速向前奔跑"、"流畅地行走"、"剧烈挥动手臂"
• ❌ 避免："移动"、"走动"、"稍微动一下"等模糊描述。

简易工作流示例逻辑

[Load Image] --> [PainterI2V] --> [VAE Decode] --> [Save Video]
                      ^
                      |
            [Positive Prompt: "Running fast"]
            [motion_amplitude: 1.25]
            [Wan2.2 Model & LoRA]

只需将原工作流中的标准节点替换为此节点，并微调幅度参数，即可立即获得动态更强的视频输出。