Wan2GP项目完全使用指南：从入门到精通AI视频生成

项目概述

Wan2GP（Wan for the GPU Poor）是一个开源AI视频生成工具，专为VRAM有限的用户设计。该项目支持多种视频生成模型，包括Wan系列、Hunyuan Video和LTX Video等，能够在低至6GB VRAM的硬件配置下运行。

项目架构解析

Wan2GP采用模块化设计，主要目录结构如下：

• defaults/: 包含各种模型的默认配置文件
• docs/: 完整的文档目录，包含安装、使用、故障排除等指南
• models/: 核心模型实现，按功能分类组织
• plugins/: 插件系统，支持功能扩展
• profiles/: 预设配置方案，便于快速上手

安装与配置

一键安装（推荐）

使用Pinokio App进行安装是最简单的方式。在Pinokio中搜索并使用社区脚本"wan2gp"或"wan2gp-amd"。

手动安装步骤

git clone https://gitcode.com/gh_mirrors/wa/Wan2GP.git
cd Wan2GP
conda create -n wan2gp python=3.10.9
conda activate wan2gp
pip install torch==2.6.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/test/cu124
pip install -r requirements.txt

Docker安装

对于Debian系系统（Ubuntu、Debian等）：

./run-docker-cuda-deb.sh

该脚本会自动检测GPU型号和VRAM，选择最优的CUDA架构，并配置最佳运行环境。

核心功能详解

文本到视频生成

Wan2GP支持多种文本到视频模型：

• Wan 2.1 T2V 1.3B: 速度最快，VRAM需求最低（6GB），质量良好
• Wan 2.1 T2V 14B: 质量最佳，需要更多VRAM（12GB+）
• Hunyuan Video: 优秀的生成质量，生成速度较慢

图像到视频生成

• Wan Fun InP 1.3B: 快速的图像动画
• Wan Fun InP 14B: 更高质量的图像动画

快速入门指南

首次启动

执行以下命令启动Wan2GP：

python wgp.py

系统将自动打开浏览器，显示Wan2GP的Web界面。

生成第一个视频

1. 启动Wan2GP：python wgp.py
2. 打开浏览器：访问 http://localhost:7860
3. 输入提示词："一只猫在花园里散步"
4. 点击生成按钮，等待视频生成完成
5. 在输出区域查看生成的视频

推荐初始设置

• 模型: Wan 2.1 text2video 1.3B（更快，VRAM需求更低）
• 帧数: 49（约2秒）
• 步数: 20（速度与质量的良好平衡）

高级功能应用

插件系统

Wan2GP支持插件扩展，目前已包含多个实用插件：

• wan2gp-motion-designer/: 运动轨迹设计器，可控制视频中的物体运动
• wan2gp-plugin-manager/: 插件管理器
• wan2gp-video-mask-creator/: 视频遮罩创建器

无头模式处理

对于批量处理需求，Wan2GP支持无头模式：

# 处理保存的队列
python wgp.py --process my_queue.zip

# 处理设置文件
python wgp.py --process my_settings.json

配置优化技巧

VRAM优化策略

• 内存配置文件: 可根据硬件配置选择不同级别的内存优化方案
• 量化支持: 支持4位和8位量化，显著降低内存占用
• 模型卸载: 智能模型加载和卸载机制

性能调优

• 注意力机制: 支持多种注意力优化方案
• 缓存策略: 支持TeaCache和MagCache等缓存技术

故障排除

常见问题解决

内存不足错误：

1. 使用较小的模型（1.3B而非14B）
2. 减少帧数
3. 在高级设置中降低分辨率
4. 启用量化（通常默认开启）

生成速度慢：

1. 使用1.3B模型提高速度
2. 减少步数
3. 安装Sage attention优化性能

提示词优化

基本结构：

[主体] [动作] [场景] [风格/质量修饰词]

优质提示词示例：

一辆红色跑车在日落时分的山路上行驶，电影感，高质量

一个长发女子在海滩上散步，背景有波浪，写实，细节丰富

一只猫坐在窗台上看雨，舒适的氛围，柔和的光线

最佳实践建议

硬件配置推荐

• 入门级: 6-8GB VRAM，使用1.3B模型
• 中级: 10-12GB VRAM，使用14B模型或Hunyuan
• 高级: 16GB+ VRAM，任意模型，支持更长视频

工作流程优化

1. 队列管理: 使用队列系统创建视频生成任务列表
2. 设置导出: 可导出和导入生成设置
3. 批量处理: 利用无头模式进行大规模视频生成

版本更新说明

Wan2GP持续更新，最新版本（2026年1月）包含：

• Wan 2.2 i2v Stable Vision Infinity Pro 2: 支持无限视频延续
• Wan 2.1 Alpha 2: 生成具有精细alpha细节的透明视频
• Qwen Image 2512: 增强的人类真实感，更精细的自然细节

社区与支持

• Discord服务器: 获取其他用户帮助并展示最佳视频
• Twitter/X关注: 获取最新动态和更新信息

通过掌握上述内容，您将能够充分利用Wan2GP的强大功能，创作出令人惊艳的AI生成视频内容。