pyVideoTrans

Appearance

使用 Index-TTS 作为配音渠道 ​

一、什么是 Index-TTS ​

Index-TTS 是 B站开源的 TTS 服务，支持中文和英文语音克隆，音质效果优秀。

Index-TTS 开源地址：https://github.com/index-tts/index-tts

二、前置条件 ​

条件说明
pyVideoTrans 版本v3.66 或更高版本
硬件建议有 NVIDIA 显卡（GPU 加速）
操作系统Windows（整合包）、Linux/macOS（源码部署）

三、Windows 整合包（推荐新手） ​

下载 ​

启动 ​

  1. 下载后解压
  2. 双击 启动webui.bat
  3. 等待自动下载模型
  4. 启动完成后，默认地址是 http://127.0.0.1:7860

四、源码部署 ​

请参照官方项目说明文档部署：https://github.com/index-tts/index-tts

部署完成后启动 webui.py，默认地址是 http://127.0.0.1:7860。

五、在 pyVideoTrans 中使用 ​

配置步骤 ​

  1. 启动 Index-TTS WebUI（确保浏览器能打开 http://127.0.0.1:7860）
  2. 打开 pyVideoTrans，点击菜单 → TTS设置 → F5-TTS/Spark-TTS/index-TTS/Dia-TTS
  3. 在「IndexURL」文本框中填写：http://127.0.0.1:7860
  4. 点击「测试」，若无报错则配置成功
  5. 在主界面「配音渠道」下拉列表中选择「Index-TTS」

注意：仅对接 Index-TTS 官方 WebUI。

六、参考音频要求 ​

项目要求
格式WAV 格式（推荐）
时长3~10 秒（最佳）
内容发音清晰，无背景噪音
放置位置pyVideoTrans 根目录下的 f5-tts 文件夹

参考音频格式 ​

音频文件名.wav#音频对应的文字内容

源码代码验证（_index.py）：Index-TTS 使用 /gen_single Gradio API 端点，支持 v1 和 v2 版本。v2 版本额外支持情感控制（emo_control_method），默认选项为 Same as the voice reference（与音色参考音频相同）。

七、常见问题 ​

1. 第三方整合包无法使用 ​

如果你使用了第三方整合包，请用 Index-TTS 官方源码 中的 webui.py 文件覆盖三方包的 webui.py，然后启动该 webui.py，否则可能无法使用。

2. 报错 配音全部失败 Value: 'Same as the voice reference' is not in the list of choices ​

或者报错 Value: '与音色参考音频相同' is not in the list of choices。

解决方法：打开 Index-TTS 项目的 webui.py 文件，搜索 i18n("与音色参考音频相同")，替换为 Same as the voice reference。

3. 连接失败 ​

确保：

  • Index-TTS WebUI 已启动
  • 地址填写正确（默认 http://127.0.0.1:7860）
  • 浏览器能正常打开 WebUI 界面

4. 模型下载慢 ​

首次启动需要下载模型，请耐心等待。如需加速可配置科学上网环境。