📖 VideoRetalk 使用指南

⚡ 快速开始

只需三步，快速上手 VideoRetalk：

💻 安装和启动

系统要求

• 操作系统：win7 或更高版本
• 处理器：Intel
• 内存：2GB 或以上
• 磁盘空间：至少 5GB 可用空间
• 网络：需要网络连接（用于 API 调用）

启动应用

1. 找到 VideoRetalk.exe
2. 双击启动

🎯 基本操作

1. 设置 OSS存储 和 API 密钥

1. 打开应用 → 进入 设置页面
2. 找到 OSS 配置 部分
3. 输入你的 OSS信息
4. 点击 保存

1. 打开应用 → 进入 设置页面
2. 找到 API 配置 部分
3. 输入你的 百炼 API Key
4. 点击 保存

2. 上传视频

1. 点击 上传视频 按钮
2. 选择要编辑的视频文件
3. 支持格式：MP4、MOV、AVI、MKV 等
4. 文件大小：建议不超过 500MB

3. 输入台词

1. 在文本框中输入你想让视频人物说的话
2. 支持中文、英文等多种语言
3. 可以输入多段台词（用换行符分隔）

4. 选择音色

点击 音色选择 下拉菜单，选择合适的音色：

• 🎤 标准男声
• 🎤 标准女声
• 🎤 温柔女声
• 🎤 磁性男声
• 🎤 自定义音色

5. 生成视频

1. 点击 生成视频 按钮
2. 应用开始处理（进度条显示进度）
3. 处理时间取决于视频长度和系统性能
4. 完成后，点击 下载 保存视频

✨ 功能详解

🎤 AI 语音合成

使用阿里云百炼 TTS 技术，支持多种音色和语言，生成自然流畅的语音。

• 支持多种音色
• 支持多种语言
• 自然流畅的语音质量

👄 对口型生成

自动分析视频中人物的嘴型，匹配语音内容，生成自然同步的对口型视频。

• 自动识别人脸
• 提取嘴型特征
• 根据语音调整嘴型

🎨 音色克隆

支持音色克隆功能，用特定人物的声音进行语音合成，保留原有的音色特征。

1. 上传参考音频（3-10 秒）
2. 输入要合成的文案
3. 系统自动克隆音色
4. 生成带有克隆音色的语音

🔒 本地隐私

所有用户数据存储在本地，不上传到第三方服务器，完全保护用户隐私。

❓ 常见问题

Q1: 应用启动很慢怎么办？

A: 首次启动需要初始化，可能需要 30-60 秒。如果持续缓慢：

• 检查网络连接
• 重启应用
• 检查系统资源（CPU、内存）

Q2: 生成视频失败怎么办？

A: 可能的原因：

• ❌ API Key 配置错误 → 检查设置中的 API Key
• ❌ 网络连接问题 → 检查网络
• ❌ 视频格式不支持 → 转换为 MP4 格式
• ❌ 视频文件损坏 → 尝试其他视频

Q3: 如何关闭应用？

A: 三种方式：

• Dock：右键 VideoRetalk → 退出
• Activity Monitor：搜索 VideoRetalk → 强制退出
• 命令行：killall -9 VideoRetalk

Q4: 生成的视频在哪里？

A: 生成的视频保存在：

~/VideoRetalk/downloads/

Q5: 支持哪些视频格式？

A: 支持的格式：

• ✅ MP4（推荐）
• ✅ MOV
• ✅ AVI
• ✅ MKV
• ✅ WebM

🔧 故障排除

问题 1: "API Key 无效"

解决方案：

1. 检查 API Key 是否正确复制
2. 确认 API Key 未过期
3. 检查网络连接
4. 重新输入 API Key

问题 2: "无法识别人脸"

解决方案：

1. 确保视频中有清晰的人脸
2. 人脸应该面向摄像头
3. 光线要充足
4. 尝试其他视频

问题 3: "对口型不同步"

解决方案：

1. 检查音频质量
2. 确保文案与音频匹配
3. 尝试调整音色
4. 重新生成视频

问题 4: "应用崩溃"

解决方案：

1. 重启应用
2. 检查系统资源
3. 更新 macOS
4. 重新安装应用

问题 5: "生成速度很慢"

解决方案：

1. 检查网络连接
2. 关闭其他应用释放资源
3. 使用更小的视频文件
4. 检查 CPU 和内存使用情况