#5014 videotrans.configure.excepts.DubbingSrtError: {

试听时返回 {"detail":"Not Found"，说明请求的 TTS 服务接口或配音角色不存在。

常见原因与解决方法：

1. TTS 服务未运行或地址错误

   • 若使用本地 API 渠道（如 F5-TTS、CosyVoice、GPT-SoVITS），请确认后端服务正在运行，且 菜单 → TTS设置 中填写的 API 地址和端口号正确（如 http://127.0.0.1:7860）。
   • 若使用在线 API（如 Azure TTS、Elevenlabs），请检查 API Key 和端点 URL 是否正确。

2. 配音角色名称不匹配

   • Edge-TTS 等渠道的某些语言中，部分角色可能已被移除或改名。请在 目标语言 选定后，重新展开 配音角色 下拉列表确认所选角色是否存在。
   • 对于本地 API 渠道，配音角色列表来自服务端返回，请确保服务端已正确配置并返回角色列表。

3. API 请求路径错误

   • 部分自定义 API 渠道需要填写完整的请求路径（含 /v1/... 等），仅填 IP+Port 可能导致 404。请对照渠道文档补全路径。

建议按顺序检查以上三项，修改后重新点击试听。如果问题仍存，请提供你当前使用的 配音渠道 名称及对应的设置截图，以便进一步排查。

请查阅相关文档：

• F5-TTS 等本地 API 设置
• Edge-TTS 配音故障排查
• 自定义 TTS API

D:\BaiduNetdisk

D:\BaiduNetdisk

D:\BaiduNetdisk

D:\BaiduNetdisk

D:\BaiduNetdisk

To create a public link, set share=True in launch().

试听返回“Not Found”，是因为 pyVideoTrans 请求的 GPT-SoVITS API 路径或角色名称与服务端不匹配。从你提供的启动日志看，GPT-SoVITS 服务运行在 http://0.0.0.0:9874。

请按以下步骤检查并修正：

1. 统一 API 地址
   在 pyVideoTrans 菜单 → TTS设置 → GPT-SoVITS 中，将 URL 设为 http://127.0.0.1:9874（不要用 0.0.0.0，本地连接必须用 127.0.0.1 或 localhost）。确认端口号 9874 无误。
2. 确认 api_v2 勾选状态
   根据你使用的 GPT-SoVITS-v2pro 版本，大概率需要勾选 “api_v2” 复选框。如果服务是非 v2 接口，则不勾选。你可以在 GPT-SoVITS 服务端查看 API 路径：若返回 404 且路径为 /tts，则可能不是 v2 需取消勾选。不确定时可先勾选尝试，若仍报 404 再取消。

3. 检查参考音频配置

   • 参考音频必须是 3–10 秒的 .wav 文件，放在 GPT-SoVITS 根目录（与你启动服务的目录一致）。
   • 在 pyVideoTrans 的 GPT-SoVITS 设置界面中，参考音频名称 填写完整文件名（如 ref.wav）。
   • 如果试听时没有使用参考音频，也需要先配置一个有效音频，否则 API 会拒绝请求并返回 404。
4. 重启服务后再次试听
   修改完上述配置后，重新试听。如果问题依旧，打开 pyVideoTrans 的 logs 文件夹查看最新日志，找出更详细的错误状态（如 404、500 等）。

请查阅相关文档：

• GPT-SoVITS 配置详解
• GPT-SoVITS 常见问题

{"detail":"Not Found"}:
Traceback (most recent call last):
File "videotrans\util\ListenVoice.py", line 16, in run
File "videotrans\tts\__init__.py", line 184, in run
File "videotrans\tts\_base.py", line 134, in run
videotrans.configure.excepts.DubbingSrtError: {"detail":"Not Found"}

请执行以下精确排查操作：

1. 验证 GPT-SoVITS API 根路径
   在浏览器中直接打开 http://127.0.0.1:9874/ —— 如果看到网页或 JSON 响应，说明服务正常。接着尝试 http://127.0.0.1:9874/tts（GET 或 POST），看是否返回 404。若返回 404，说明路径不是 /tts。

   常见路径有：

   • v2 接口：/v2/tts
   • 老版本：/run/predict 或 /api/tts
     请根据服务端的实际路径修改 pyVideoTrans 中的 URL。
     最简单的方法：在 GPT-SoVITS 启动窗口上，通常启动后会有类似 Running on local URL: http://0.0.0.0:9874 的提示，有些版本还会打印出 /docs 或 /api 信息，留意这些信息。
2. 检查 api_v2 勾选状态
   如果你的 GPT-SoVITS 是 v2pro 版本，则 API 路径可能不是标准 v2。
   请交替勾选/取消勾选“api_v2”复选框，并每次修改后进行试听测试。
   如果取消勾选后试听成功，说明接口是古早版本。

3. 确认参考音频放置位置

   • 参考音频必须放在 GPT-SoVITS 根目录下（即启动 webui.py 的那个目录），而非 pyVideoTrans 的 f5-tts 文件夹。
   • 音频必须是 .wav 格式，时长 3~10 秒。
   • 在 pyVideoTrans GPT-SoVITS 设置界面的“参考音频名称”中，仅填写文件名（含后缀），例如 myref.wav（不要带路径）。
4. 观察服务端日志
   当你在 pyVideoTrans 中点击试听时，看看 GPT-SoVITS 的命令行窗口是否出现新的请求日志。如果出现 404 或 Not Found 的日志输出，则能直接看出它收到的请求 URL 是什么，据此调整 pyVideoTrans 的 URL 配置即可。

5. 临时测试 API 连通性
   打开 Windows 的命令提示符（CMD），执行以下 curl 命令（如果系统没有 curl 可以安装，或使用浏览器插件测试；也可直接使用 Postman）：

   curl -X POST "http://127.0.0.1:9874/v2/tts" -H "Content-Type: application/json" -d "{\"text\":\"测试\",\"refer_wav_path\":\"你的参考音频名.wav\"}"

   如果返回 404，则尝试将路径改为 /tts、/run/predict、/api/tts 等，直到找到正确路径。一旦在 curl 中成功，将相同路径填入 pyVideoTrans 的 URL 字段（末尾不需要 /v2/tts 之后的路径，只需填写基础 URL，路径由软件自动拼接；具体参考文档）。

如果完成以上所有步骤仍无法解决，请提供 软件安装目录下 logs/ 文件夹中最新的 .log 日志文件内容（复制最后 30 行），以及 GPT-SoVITS 命令行窗口在点击试听时的输出信息，以便进一步分析。

出错了
X
连接被拒绝，目标服务可能未运行或端口错误：
Traceback (most recent call last):
File"httpxtransports\default.py",line 101,in
map_httpcore_exceptions
File"httpxtransporsdefault.pyline25,inhandlerequest
Fierscneiqs
File "httpcoreLsync)conne

连接被拒绝说明 GPT-SoVITS 服务已停止运行或端口不对。请按以下顺序排查：

1. 检查服务是否还活着
   查看启动 GPT-SoVITS 的命令行窗口（黑色控制台）是否已关闭？如果关闭了，需要重新运行 runtime\python.exe -I webui.py zh_CN 启动服务，并确保启动后显示 Running on local URL: http://0.0.0.0:9874。
2. 确认端口没有被占用
   打开新的命令提示符，执行：
   netstat -ano | findstr :9874
   如果没有任何输出，说明端口上无服务在监听。如果有输出，检查 PID 是否对应 python 进程。
3. 检查 pyVideoTrans 中的 URL 配置
   菜单 → TTS设置 → GPT-SoVITS，URL 务必填写 http://127.0.0.1:9874（不要用 0.0.0.0）。如果前面改过其他端口，请恢复为 9874。
4. 重启服务
   关闭现有的 GPT-SoVITS 控制台窗口，重新双击启动脚本或运行上述命令，等待服务完全就绪后，再在 pyVideoTrans 中点击试听。
5. 防火墙干扰
   临时关闭 Windows 防火墙或添加例外规则：允许 Python 通过 9874 端口。

完成以上检查后，如果仍然连接被拒绝，请提供以下信息以便进一步排查：

• GPT-SoVITS 控制台窗口的完整输出（从启动到停止或当前状态）
• pyVideoTrans 中 GPT-SoVITS 设置界面的截图（URL 和 api_v2 勾选状态）
• 软件 logs/ 文件夹下最新的日志文件内容（最后 30 行）

请查阅相关文档：

• GPT-SoVITS 配置详解
• GPT-SoVITS 常见问题

Active code page: 65001
检测模型是否下载...
warning: No requires-python value found in the workspace. Defaulting to >=3.10.
Failed to canonicalize script path

开始启动,用时可能较久，请耐心等待...

warning: No requires-python value found in the workspace. Defaulting to >=3.10.
Required file checkpoints\bigvgan_generator.pth does not exist. Please download it.
Press any key to continue . . .

GPT-SoVITS 服务无法启动：缺失模型文件 checkpoints\bigvgan_generator.pth

启动日志明确提示 Required file checkpoints\bigvgan_generator.pth does not exist，导致服务根本未运行，因此 pyVideoTrans 连接被拒绝。

解决方法：

1. 确认模型文件完整
   进入 GPT-SoVITS 根目录下的 checkpoints 文件夹，检查是否存在 bigvgan_generator.pth 文件。如果文件不存在或为空，说明模型下载不完整。

2. 手动下载或运行下载脚本

   • 在 GPT-SoVITS 的启动脚本（如 webui.bat 或 启动.bat）中，通常内置了自动下载逻辑。如果网络问题导致下载失败，可以手动从官方仓库（HuggingFace 或 GitHub Releases）下载 bigvgan_generator.pth，放入 checkpoints 文件夹。
   • 具体下载地址请参考 GPT-SoVITS 项目文档或启动时的提示信息。常见路径例如：
     https://huggingface.co/lj1995/GPT-SoVITS/resolve/main/checkpoints/bigvgan_generator.pth
3. 重新启动服务
   确保文件完整后，重新运行启动命令（例如 runtime\python.exe -I webui.py zh_CN），等待显示 Running on local URL: http://0.0.0.0:9874 后再试。
4. 验证是否还有其他缺失文件
   如果仍报其他 .pth 缺失，按相同方法补充全部缺失模型。

完成上述操作后，pyVideoTrans 的连接被拒绝问题即可解决。

请查阅相关文档：

• GPT-SoVITS 配置与模型下载