#3785 配置本地部署的GPT-SoVITS报错AttributeError: 'NoneType' object has no attribute 'keys'

该错误是由于 GPT-SoVITS 服务未正确启动或连接失败，导致软件获取到的 API 响应为 None。

1. 检查 GPT-SoVITS API 服务：确保 GPT-SoVITS 的 API 服务已在本机启动，并且运行在正确的地址（通常是 http://127.0.0.1:9880 或 http://127.0.0.1:9872）。
2. 验证 API 地址配置：在 pyVideoTrans 中，进入 菜单 -> 翻译设置 -> GPT-SoVITS，确认“API 地址”填写正确，例如 http://127.0.0.1:9880。
3. 测试 API 连通性：在浏览器中访问你配置的 API 地址（例如 http://127.0.0.1:9880），查看是否能正常打开 GPT-SoVITS 的 WebUI 页面。如果无法访问，说明服务未启动。
4. 重启服务：关闭 GPT-SoVITS 的终端/服务窗口，然后按照其官方文档的指引重新启动 API 服务。
5. 检查参考音频：如果使用了 clone 角色，请确保原始视频的语音片段（作为参考音频）时长在 3-10 秒之间。过短或过长的参考音频可能导致克隆失败。

请查阅相关文档：

• GPT-SoVITS API 使用方法

必须在设置窗口里填写 参考音频

原音色克隆，也必须在设置窗口里填写 参考音频吗？

是的。根据开发者回复，无论使用原音色克隆还是其他声音克隆功能，只要选择了 clone 配音角色，都必须在设置窗口里填写参考音频。

具体操作步骤如下：

1. 在软件主界面选择配音渠道为 GPT-SoVITS 或其他支持克隆的渠道（如 F5-TTS、CosyVoice）。
2. 在配音角色中选择 clone。
3. 点击主界面右上角的 设置 按钮（或通过 菜单 -> 翻译设置 -> 进入对应配音渠道的设置面板）。
4. 在设置窗口中，找到“参考音频”或类似选项，点击并选择一段 3-10 秒的、清晰的人声音频文件作为克隆音色的参考。
5. 保存设置后，再进行视频翻译或配音任务。

请查阅相关文档：

• 如何使用原视频中音色配音
• GPT-SoVITS API 使用方法

有用，解决了。

问题已解决。