这是由于连接外部 TTS 服务(如 F5-TTS、Spark-TTS、Qwen-TTS 等)时,无法获取其 Gradio WebUI 的配置信息导致的。常见原因是服务未启动、网络地址配置错误或服务端本身的问题。
请按以下步骤排查:
确认外部 TTS 服务已正确启动:
- 确保你已按照对应 TTS 项目(如 F5-TTS、Spark-TTS、Qwen-TTS)的说明,在本地或服务器上成功部署并启动了其 API 服务。启动后,通常会有一个终端窗口保持运行。
- 在浏览器中直接访问你配置的 API 地址(例如
http://127.0.0.1:7860),检查是否能正常打开其 WebUI 界面。如果打不开,说明服务未运行。
检查 pyVideoTrans 中的配置:
- 在 pyVideoTrans 的“配音设置”或“TTS设置”中,找到你正在使用的 TTS 渠道(如 F5-TTS、Qwen-TTS本地)。
- 核对“API地址”是否与外部服务实际运行的地址和端口完全一致。常见的本地地址是
http://127.0.0.1:7860 或 http://localhost:7860。请确保地址末尾没有多余的斜杠 /。
针对特定服务的额外检查:
- 对于 Qwen-TTS(本地):请确认你启动的模型类型与你在软件中选择的配音角色匹配。例如,使用
clone 角色或参考音频时,必须启动语音克隆模型(Qwen3-TTS-12Hz-0.6B-Base 等);使用内置音色(如“Vivian”)时,必须启动自定义音色模型(Qwen3-TTS-12Hz-0.6B-CustomVoice 等)。启动错误的模型会导致无法找到对应的 API 端点(/run_voice_clone 或 /run_instruct)。
重启服务与软件:
- 尝试关闭外部 TTS 服务的终端窗口,然后重新启动其服务。
- 重启 pyVideoTrans 软件,再次尝试。
检查防火墙/网络:
- 如果服务运行在非本机的服务器上,请确保服务器防火墙已放行对应端口(如 7860),并且网络可通。
请查阅相关文档: