如果你在使用Stable Diffusion(尤其是AUTOMATIC1111的WebUI版本)生成AI图像或视频,你可能听说过SadTalker这个强大的扩展插件。它可以将静态图片与音频结合,生成逼真的“会说话的头像”视频。本文将为你提供SadTalker的Git仓库网址,以及安装和使用的实用指南、详细步骤和常见问题解答,帮助你快速上手并优化使用体验。
SadTalker简介
SadTalker是一个开源项目,由西安交通大学、腾讯AI实验室等机构的研究人员开发,最初发布于2023年的CVPR会议。它利用3D运动系数和音频驱动技术,能让单张人像图片“开口说话”,适用于虚拟主播、动画制作等场景。作为Stable Diffusion的扩展插件,SadTalker与WebUI无缝集成,操作简单且功能强大。无论你是制作虚拟内容还是探索AI技术,SadTalker都是一个值得尝试的工具。
SadTalker的Git仓库网址
SadTalker的官方Git仓库有两个主要版本,具体取决于你的需求:
- 官方版本:https://github.com/OpenTalker/SadTalker.git – 这是SadTalker的主要仓库,包含最新更新和完整文档。
- 社区优化版本:https://github.com/Winfredy/SadTalker.git – 由社区维护,稍微简化了一些安装步骤,适合初学者。
建议使用官方版本,因为它更新更频繁,且有详细的安装说明和技术支持。以下内容将以官方版本为基础展开。

如何安装SadTalker到Stable Diffusion
在AUTOMATIC1111的Stable Diffusion WebUI中安装SadTalker需要一些准备工作和具体步骤。以下是详细的安装指南,涵盖环境配置、依赖安装和故障排查。
1. 准备环境
在开始安装之前,确保你的系统满足以下基本要求:
- 操作系统:Windows 10/11、Linux(如Ubuntu 20.04+)或macOS(10.15+)。
- Python版本:推荐使用3.10.6(SadTalker对3.8-3.10兼容,但3.10表现更稳定)。运行python –version确认版本。
- Stable Diffusion WebUI:确保已安装最新版本的AUTOMATIC1111 WebUI。可以从其官方仓库(https://github.com/AUTOMATIC1111/stable-diffusion-webui)克隆并运行。
- Git:用于下载SadTalker仓库。运行git –version检查是否安装,若未安装:
- Windows:从https://git-scm.com/download/win下载并安装,勾选“Add Git to PATH”。
- Linux:运行sudo apt install git(Ubuntu)或sudo yum install git(CentOS)。
- macOS:通过Homebrew运行brew install git。
- FFmpeg:SadTalker需要FFmpeg处理音频和视频。安装方法:
- Windows:从https://ffmpeg.org/download.html下载,或用Scoop(`scoop install ffmpeg`)。
- Linux:运行sudo apt install ffmpeg。
- macOS:运行brew install ffmpeg。 检查安装:运行ffmpeg -version,应返回版本信息。
2. 启动Stable Diffusion WebUI
- 进入Stable Diffusion WebUI目录(例如C:\stable-diffusion-webui)。
- 运行启动脚本:
- Windows:双击webui-user.bat。
- Linux/macOS:运行./webui.sh。
- 启动后,浏览器会打开本地地址(通常是http://127.0.0.1:7860),进入WebUI界面。
3. 通过扩展页面安装SadTalker
- 在WebUI顶部导航栏,点击“Extensions”标签。
- 选择“Install from URL”选项。
- 在“URL for extension’s Git repository”字段中输入官方SadTalker仓库地址:https://github.com/OpenTalker/SadTalker.git。
- 点击“Install”按钮,等待下载完成。下载过程可能需要几分钟,取决于网络速度。
- 下载完成后,返回“Installed”选项卡,确认SadTalker出现在列表中。
4. 下载并配置检查点文件
SadTalker需要额外的模型文件(checkpoints)才能运行。这些文件不会自动下载,需要手动获取并放置到正确目录。
- 下载地址:访问https://github.com/OpenTalker/SadTalker#downloads,下载以下文件:
- mapping_00109-model.pth.tar
- mapping_00229-model.pth.tar
- SadTalker_V0.0.2_256.safetensors(低分辨率模型)
- SadTalker_V0.0.2_512.safetensors(高分辨率模型)
- 放置路径:将下载的文件放入以下任一目录:
- stable-diffusion-webui/extensions/SadTalker/checkpoints/(推荐)。
- 或stable-diffusion-webui/models/SadTalker/。
- 可选脚本下载(Linux/macOS):在终端进入SadTalker目录(cd stable-diffusion-webui/extensions/SadTalker),运行:
bash <(wget -qO- https://raw.githubusercontent.com/OpenTalker/SadTalker/main/scripts/download_models.sh)这会自动下载并放置模型文件。
5. 安装依赖项
SadTalker依赖一些Python库(如librosa、torch等)。WebUI通常会自动安装,但有时需要手动处理:
- 在WebUI目录下打开终端,运行:
pip install -r extensions/SadTalker/requirements.txt - 如果遇到版本冲突(如librosa或numpy),尝试指定兼容版本:
pip install librosa==0.10.0 numpy==1.23.5 - 确保PyTorch支持GPU(若有NVIDIA显卡):
pip install torch torchvision --extra-index-url https://download.pytorch.org/whl/cu118检查GPU支持:运行python -c “import torch; print(torch.cuda.is_available())”,应返回True。
6. 重启并验证
- 在WebUI的“Extensions”页面,点击“Apply and restart UI”。
- 重启后,检查界面是否出现“SadTalker”选项卡。若未出现,查看终端日志排查问题。
安装过程中的额外细节与注意事项
- CPU模式:若无GPU,需在启动脚本中添加参数:
- Windows:编辑webui-user.bat,添加–disable-safe-unpickle。
- Linux/macOS:在webui.sh中添加同样参数。
- 文件权限:Windows用户确保对WebUI目录有写入权限,避免模型文件无法保存。
- 网络问题:若Git下载失败,可手动下载ZIP包(https://github.com/OpenTalker/SadTalker/archive/refs/heads/main.zip),解压到`extensions/`目录并重命名为`SadTalker`。
实用Q&A
Q1:安装时提示缺少模型文件怎么办?
A:SadTalker需要额外的检查点文件(如mappingnet和facevid2vid模型)。你需要在官方仓库的Downloads部分(https://github.com/OpenTalker/SadTalker#downloads)手动下载,然后将文件放入`stable-diffusion-webui/extensions/SadTalker/checkpoints`目录。如果仍出错,可在`webui-user.bat`中设置环境变量:`set SADTALKER_CHECKPOINTS=你的模型路径`。
Q2:生成视频时速度很慢,有什么优化方法?
A:生成速度受硬件和设置影响。建议:
- 使用GPU加速(需NVIDIA显卡和CUDA支持)。
- 关闭“GFPGAN as Face Enhancer”选项,此功能会显著增加处理时间。
- 缩短音频长度,减少生成帧数。
Q3:支持中文音频吗?
A:支持!SadTalker对音频内容没有语言限制,只要是清晰的WAV或MP3格式即可。中文语音也能很好地驱动唇部动作。
Q4:安装失败,报错“Git命令不可用”怎么办?
A:说明你的系统未安装Git。Windows用户可从https://git-scm.com/download/win下载并安装,安装时勾选“Add Git to PATH”。完成后重试安装步骤。
Q5:生成的嘴部动作不自然,可能是什么原因?
A:可能原因包括:
- 图片中脸部角度不正,建议使用正面或接近正面的图像。
- 音频质量差,尝试使用更清晰的录音。
- 调整“Still Mode”或“Preprocess”设置,优化输出效果。
故障排查补充
- 选项卡未显示:
- 检查checkpoints目录是否包含所有模型文件。
- 查看WebUI终端日志,可能提示缺少依赖或路径错误。
- FFmpeg未找到:确保FFmpeg已加入系统PATH。Windows用户可在命令提示符运行set PATH=%PATH%;C:\path\to\ffmpeg\bin,替换为实际路径。
- 依赖冲突:若报错涉及librosa或numpy,卸载后重新安装兼容版本。
使用技巧与注意事项
- 图片选择:优先使用高分辨率、正面人像图片,避免模糊或遮挡。
- 音频准备:推荐使用短音频(5-15秒),过长可能导致生成时间过久。
- 定期更新:SadTalker仍在开发中,定期检查Git仓库更新以获取新功能和修复。
SadTalker是Stable Diffusion生态中一个令人兴奋的扩展,能轻松将静态图片变为动态说话视频。通过本文提供的Git仓库网址、详细安装步骤和实用Q&A,你可以快速上手并解决常见问题。无论是初学者还是有经验的用户,这些信息都能帮助你更好地利用SadTalker,创造属于你的AI虚拟主播或其他创意内容。快去试试吧,探索AI技术的无限可能!

