开始使用 VideoLingo：你的视频翻译助手

在全球化的今天，视频内容的翻译与本地化变得愈加重要。VideoLingo 作为一款创新的视频翻译工具，旨在帮助用户轻松实现高质量的字幕和配音。本文将详细介绍如何配置和使用 VideoLingo，助你快速上手，享受无障碍的视频体验。

📋 API 配置指南

要使用 VideoLingo，首先需要配置大模型和文本转语音（TTS）服务。为了追求最佳的翻译质量，推荐使用 claude-3-5-sonnet-20240620 与 Azure TTS。用户可以选择使用 302AI 提供的 API Key，这样一个 Key 就能使用所有服务。此外，用户也可以选择完全本地化的体验，使用 Ollama 作为大模型，Edge TTS 作为配音，这样就无需任何 API Key。

1. 大模型的 API_KEY

以下是推荐的大模型及其相关信息：

注意：支持 OpenAI 格式接口，用户可以自行尝试不同模型，但不建议使用小于 30B 的模型，因为处理过程涉及多步思维链和复杂的 JSON 格式。

2. TTS 的 API

VideoLingo 提供了多种 TTS 接入方式，以下是对比：

注意：SiliconFlow FishTTS 需要在 硅基流动 获取 Key，克隆功能需要付费充值积分。

🛠️ 快速上手

VideoLingo 支持 Windows、macOS 和 Linux 系统，用户可以选择使用 CPU 或 GPU 运行。

安装步骤

1. 安装必要软件：

   • 在 Windows 上使用 NVIDIA GPU 加速，请安装 CUDA Toolkit 12.6 和 CUDNN 9.3.0。
   • 确保将 C:\Program Files\NVIDIA\CUDNN\v9.3\bin\12.6 添加到系统 PATH，并重启电脑。
   • 安装 FFmpeg，Windows 用户可以使用 Chocolatey：

     choco install ffmpeg
     

   • macOS 用户使用 Homebrew：

     brew install ffmpeg
     

   • Linux 用户使用 apt 或 dnf 安装 FFmpeg。

2. 克隆项目：

   git clone https://github.com/Huanshere/VideoLingo.git
   cd VideoLingo
   

3. 创建并激活虚拟环境（必须使用 Python 3.10.0）：

   conda create -n videolingo python=3.10.0 -y
   conda activate videolingo
   

4. 运行安装脚本：

   python install.py
   

5. 启动应用：
   输入命令或点击 一键启动.bat 启动 Streamlit 应用：

   streamlit run st.py
   

6. 设置 API Key：
   在弹出网页的侧边栏中设置你的 API Key，开始使用 VideoLingo。

🚨 常见报错

在使用过程中，可能会遇到一些常见错误，以下是解决方案：

1. 翻译过程的 ‘All array must be of the same length’ 或 ‘Key Error’：

   • 原因：弱模型遵循 JSON 格式能力较弱，导致响应解析错误。
   • 解决方案：检查 output/gpt_log/error.json 的 response 和 msg 字段，删除 output/gpt_log 文件夹后重试。

2. ‘Retry Failed’, ‘SSL’, ‘Connection’, ‘Timeout’：

   • 原因：通常是网络问题。
   • 解决方案：中国大陆用户请切换网络节点重试。

3. local_files_only=True：

   • 原因：网络问题引起的模型下载失败。
   • 解决方案：确认网络能 ping 通 huggingface.co。

结语

通过以上步骤，你可以轻松配置和使用 VideoLingo，实现高质量的视频翻译与配音。无论是个人项目还是商业需求，VideoLingo 都能为你提供强大的支持。现在就开始你的翻译之旅吧！