#5021 videotrans.configure.excepts.DubbingSrtError: {

该错误通常是因为 TTS 配音服务的 API 地址配置错误或服务未启动，导致接口返回 404 Not Found。

排查步骤：

1. 确认所使用的配音渠道

   • 如果你使用的是 Edge-TTS（免费），该渠道无需额外配置，一般不会出现 404 错误。请检查是否误选了其他需本地部署的渠道（如 F5-TTS、GPT-SoVITS、CosyVoice 等）。

2. 检查 TTS 服务 URL 配置

   • 点击菜单栏 TTS设置 → 找到你当前使用的渠道设置面板。
   • 确认 API/WebUI 地址 填写正确（例如 http://127.0.0.1:7860），端口号需与你本地部署的服务一致。
   • 若服务部署在其他电脑，请确认网络可通且防火墙未拦截。

3. 确保本地 TTS 服务已启动

   • 如果是 F5-TTS / Index-TTS / GPT-SoVITS 等本地 API 渠道，请检查对应的终端窗口是否仍在运行，服务是否正常启动（通常会有 Running on local URL: http://127.0.0.1:xxxx 的输出）。

4. 试听参考音频路径

   • 如果使用声音克隆（选中 clone 角色），请确保参考音频文件已放入 f5-tts/ 文件夹，且文件名在软件设置中正确填写（含后缀，如 1.wav）。

5. 重启软件

   • 配置修改后，点击 保存，然后重启软件再次试听。

若以上步骤无法解决，请提供 logs/ 文件夹中最新日志文件的底部约 30 行内容，以便进一步定位。

D:\BaiduNetdisk

D:\BaiduNetdisk

D:\BaiduNetdisk

D:\BaiduNetdisk

D:\BaiduNetdisk

To create a public link, set share=True in launch(). 启动了的

{"detail":"Not Found"} 表示 pyVideoTrans 向 GPT-SoVITS 的 API 地址发起了错误的请求（路径不存在）。根据你的服务日志，GPT-SoVITS 已在 0.0.0.0:9874 上成功启动，问题出在 pyVideoTrans 中 GPT-SoVITS 的设置与服务的实际 API 路径不匹配。

解决方案

1. 确认 pyVideoTrans 中的 API 地址
   打开软件菜单 → TTS设置 → GPT-SoVITS，在 URL 框中填写：

   http://127.0.0.1:9874

   不要添加任何额外路径（如 /tts、/api 等），软件内部会自动拼接正确的端点。

2. 勾选 api_v2 复选框
   你使用的是 GPT-SoVITS-v2pro，属于 v2 版本。在 GPT-SoVITS 设置面板中，务必勾选 api_v2（若未勾选，软件会使用 v1 接口路径，导致 404）。

3. 检查参考音频配置

   • 参考音频必须放置在 GPT-SoVITS 工具根目录下的指定文件夹内（一般为 GPT-SoVITS/ 下，具体位置以工具文档为准）。
   • 在 pyVideoTrans 的 GPT-SoVITS 设置界面中，填写参考音频文件名（含后缀，如 1.wav），时长 3-10 秒。
4. 重启服务与软件
   修改设置后，保存 并重新启动 pyVideoTrans，再次试听。
5. 验证 API 可用性（可选）
   在浏览器中直接访问 http://127.0.0.1:9874，如果能打开 GPT-SoVITS 的 WebUI 界面，说明服务正常。

如果以上步骤仍无法解决，请检查 GPT-SoVITS 的 API 文档，确认其实际使用的 TTS 接口路径（例如 /tts、/api/v2/tts），然后在 pyVideoTrans 的设置中尝试填写完整路径如 http://127.0.0.1:9874/tts，并取消勾选 api_v2 测试。

http://127.0.0.1:9874能打开。其他的也设置了，还是这样提示

根据你的描述，GPT-SoVITS 的 WebUI 可以访问，但 pyVideoTrans 调用时仍返回 404，说明请求路径不匹配。请按以下步骤逐一检查并调整：

1. 在 pyVideoTrans 中手动指定完整 API 路径

打开菜单 → TTS设置 → GPT-SoVITS，将 URL 字段改为完整路径：

• 尝试 1（推荐）：http://127.0.0.1:9874/api/v2/tts
  并 取消勾选 api_v2 复选框（因为路径已显式包含 /api/v2/）。
• 尝试 2（如果上面失败）：http://127.0.0.1:9874/tts，同样取消勾选 api_v2。

修改后点击 保存，重启 pyVideoTrans，再次试听。

2. 确认 GPT-SoVITS 的 API 模式是否正确

你的 GPT-SoVITS 启动命令为：

runtime\python.exe -I webui.py zh_CN

默认 webui.py 会同时启动 WebUI 和 API 服务。但有些版本需要额外添加 --api 参数才能开启 API 端口。请检查你的 GPT-SoVITS 启动脚本（webui.bat 或 start.bat），确认其中是否包含 --api。
若没有，可以关闭后重新启动，在命令末尾加上 --api：

runtime\python.exe -I webui.py zh_CN --api

然后再次尝试。

3. 验证 API 是否响应

在浏览器中直接访问以下地址，检查返回结果：

• http://127.0.0.1:9874/api/v2/tts（应返回 405 Method Not Allowed 或类似提示，说明该路径存在）
• http://127.0.0.1:9874/tts（同样检查是否 404）

如果两个路径都返回 404，说明你的 GPT-SoVITS 版本 API 路径不同，请查阅其文档或 GitHub 页面确认正确的端点。

4. 检查防火墙/进程冲突

确保没有其他程序占用 9874 端口，或防火墙未阻止 pyVideoTrans 发起请求。可以尝试暂时关闭防火墙测试。

5. 日志定位

如果以上仍无效，请打开 pyVideoTrans 的 logs/ 文件夹，找到最新日志，复制最后 30 行报错内容，以便进一步分析具体请求的 URL。

总结：优先尝试在 URL 中填写 http://127.0.0.1:9874/api/v2/tts 并取消勾选 api_v2。大部分情况下可以解决。

http://127.0.0.1:9874/api/v2/tts 这个打开是这样{"detail":"Not Found"}

/api/v2/tts 返回 404 说明该路径不存在。你的 GPT-SoVITS 版本（v2pro）可能使用了不同的 API 端点。请依次尝试以下方案：1. 确认是否已启用 API 模式 你启动的是 webui.py，某些版本需要额外添加 --api 参数才能开启 API 服务。关闭已运行的窗口，重新使用以下命令启动（或修改启动脚本）：runtime\python.exe -I webui.py zh_CN --api 启动后观察终端输出，确认是否有类似 “Running on local URL: http://0.0.0.0:9874” 的 API 提示。2. 在 pyVideoTrans 中测试不同路径 打开菜单 → TTS设置 → GPT-SoVITS，分别测试以下组合（每次修改后保存并重启软件试听）：URL：http://127.0.0.1:9874/tts，取消勾选 api_v2URL：http://127.0.0.1:9874/api/tts，取消勾选 api_v2URL：http://127.0.0.1:9874，勾选 api_v2（即最初方案，但可能因为 API 未开启而失败）3. 查阅 v2pro 文档 前往 GPT-SoVITS-v2pro 的 GitHub 页面，确认其 API 文档中 TTS 接口的具体路径（常见为 /tts 或 /api/tts）。4. 检查参考音频放置位置 确保参考音频（如 1.wav）放在了 GPT-SoVITS 的根目录下（而非 pyVideoTrans 的 f5-tts 目录），并在 pyVideoTrans 的 GPT-SoVITS 设置中填写正确的文件名。完成以上步骤后，如果仍无法解决，请提供启动 GPT-SoVITS 后终端输出的完整日志（前 20 行即可），以便定位服务实际暴露的端点。

Active code page: 65001
检测模型是否下载...

  Built indextts @ file:///D:/BaiduNetdisk-***/tts/indextts2-0529

Uninstalled 1 package in 1ms
░░░░░░░░░░░░░░░░░░░░ [0/1] Installing wheels... warning: Failed to hardlink files; falling back to full copy. This may lead to degraded performance.

     If the cache and target directories are on different filesystems, hardlinking may not be supported.
     If this is intentional, set `export UV_LINK_MODE=copy` or use `--link-mode=copy` to suppress this warning.

Installed 1 package in 18ms
Failed to canonicalize script path

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

Model directory ./checkpoints does not exist. Please download the model first.
Press any key to continue . . .

问题根源是 GPT-SoVITS 服务未正确启动——你的 checkpoints 模型文件夹缺失，服务因缺少模型而终止，导致 pyVideoTrans 调用时返回 404。

解决步骤

1. 下载 GPT-SoVITS 预训练模型

   • 前往 GPT-SoVITS-v2pro 的 GitHub Release 页面（或官方文档提供的模型下载链接），下载所需的 checkpoints 压缩包。
   • 将下载的 checkpoints 文件夹完整解压到 GPT-SoVITS 的根目录（即 webui.py 所在的文件夹）。路径示例：
     D:\BaiduNetdisk\GPT-SoVITS\GPT-SoVITS-v2pro-20250604\GPT-SoVITS-v2pro-20250604\checkpoints\

2. 重新启动 GPT-SoVITS 服务

   • 确保模型放置正确后，再次运行启动命令（建议添加 --api 参数以开启 API）：

     runtime\python.exe -I webui.py zh_CN --api

   • 等待终端输出类似 Running on local URL: http://0.0.0.0:9874，确认服务正常启动。

3. 配置 pyVideoTrans

   • 打开软件菜单 → TTS设置 → GPT-SoVITS，URL 填写 http://127.0.0.1:9874，勾选 api_v2（v2pro 使用 v2 API）。
   • 参考音频（如 1.wav，3-10 秒）放到 GPT-SoVITS 根目录，并在设置中填写完整文件名（含后缀）。
   • 保存设置后重启 pyVideoTrans 并试听。

备注

• 你的启动路径中存在 *** 掩码，请确保 GPT-SoVITS 目录名不包含特殊字符（建议改用纯英文路径）。
• 若下载模型遇到网络问题，可配置代理或从镜像站（如 hf-mirror.com）获取。

参考文档

• GPT-SoVITS 配置说明
• 模型下载与安装指南（GPT-SoVITS 官方）

完成以上步骤后，如果仍遇到 404，请再次提供 GPT-SoVITS 启动后的完整终端日志（前 30 行）以便进一步分析。

使用该接口需启动CosyVoice2/3官方项目的webui.py,cosyvoice3无法直接使用官方webui.py对接本软
件，点击右下角填写教程按钮，查看解决办法
WebUl url
http://127.0.0.1:8000promptinstruct text
保存修改
测试
设置参考音频
查看填写教程

你提供的 URL 格式不正确。http://127.0.0.1:8000promptinstruct text 并非有效的 API 地址。

正确的配置方式：

1. 启动 CosyVoice 官方服务（通常是 webui.py 或 api.py），确保终端输出类似 Running on local URL: http://0.0.0.0:8000。

2. 在 pyVideoTrans 的 菜单 → TTS设置 → CosyVoice 面板中，URL 仅填写基础地址（不含任何多余路径），例如：

   • http://127.0.0.1:8000
3. 参考音频（.wav 格式，3-10 秒）请放置到 软件根目录下的 f5-tts/ 文件夹内，并在设置中填写完整文件名（如 myvoice.wav）。
4. 保存设置后重启软件试听。

关于 CosyVoice 3 的特别说明：
官方 webui.py 可能不直接兼容本软件，请点击软件中 “查看填写教程” 按钮，按照内置指引修改或使用兼容的 API 脚本（通常是修改 webui.py 加入 --api 参数或启用特定端点）。

如果仍无法连接，请检查 CosyVoice 服务的终端窗口是否保持运行，并确认端口未被防火墙阻挡。

请查阅相关文档：

• CosyVoice 配置说明