#5024 videotrans.configure.excepts.DubbingSrtError: Parameter `emo_control_method` is not a valid key-word argument. Please cl

104.160* Posted at: 9 hours ago

Parameter emo_control_method is not a valid key-word argument. Please click on 'view API' in the footer of the Gradio app to see usage.:
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: Parameter emo_control_method is not a valid key-word argument. Please click on 'view API' in the footer of the Gradio app to see usage.


=
system:Windows-10-10.0.19045-SP0
version:v4.01
frozen:True
language:zh
root_dir:D:/BaiduNetdiskDownload/win-pyvideotrans-v4.01-0602

7 Replies

这个错误是因为 pyVideoTrans 向 GPT-SoVITS 配音服务发送了 emo_control_method 参数,但你的 GPT-SoVITS API 版本不支持该参数。

原因:GPT-SoVITS 有 api_v1api_v2 两种 API 接口,参数不同。pyVideoTrans 会根据你勾选的 api_v2 复选框决定发送哪些参数。当前你部署的 GPT-SoVITS 服务可能使用 v1 接口(不支持 emo_control_method),或者 v2 接口但该参数名称/存在性不匹配。

解决办法

  1. 打开 pyVideoTrans 菜单 → TTS 设置GPT-SoVITS 设置
  2. 找到 api_v2 复选框。

    • 如果你的 GPT-SoVITS 是较新的版本(如 V3+),尝试 勾选 api_v2
    • 如果是旧版本(V2 或 V1),尝试 取消勾选 api_v2
  3. 保存后重新试听或执行翻译任务。

如果不确定自己的 GPT-SoVITS 版本,请打开 GPT-SoVITS 的 Gradio 主页,查看页面底部的 view API 链接,确认实际接受的参数列表,确保 pyVideoTrans 发送的参数与其一致。

请查阅相关文档:

indextts2-0529 我的是这个

你的 Index-TTS 版本(indextts2-0529)的 Gradio API 接口不支持 emo_control_method 参数,但 pyVideoTrans 在调用时发送了这个参数,导致报错。

原因:pyVideoTrans 的 F5-TTS/Index-TTS 设置面板中默认可能启用了情感控制参数,而你的 Index-TTS 版本 API 不包含该参数。

解决办法(按顺序尝试)

  1. 关闭情感控制
    打开 pyVideoTrans 菜单 → TTS设置F5-TTS(Index-TTS 共用此面板),检查是否有 “情感控制”“emo_control” 相关的复选框,取消勾选后保存,重新试听或执行任务。
  2. 确认 Index-TTS 实际 API 参数
    在你运行的 Index-TTS 终端中,复制访问 Gradio 的 URL(如 http://127.0.0.1:7860),并打开 http://127.0.0.1:7860/?view=api 查看支持参数的列表。确认 emo_control_method 是否在列表中。如果不在,说明该版本不支持此功能,必须通过步骤 1 关闭。
  3. 升级 Index-TTS 或修改代码

    • 升级到更新版本的 Index-TTS(如 index-tts 最新版或更换支持情感控制的版本)。
    • 如果无法升级,也可手动修改 Index-TTS 的 webui.py,在 API 参数列表中添加一个空的 emo_control_method 参数(不推荐,但可临时解决)。不过更推荐调整 pyVideoTrans 的设置。

参考文档
Index-TTS / F5-TTS 等本地 API 配置指南

为什么一会可以一会又不可以?

间歇性报错通常由 并发请求冲突API 服务状态不稳定 导致。

核心原因

  • pyVideoTrans 默认可能使用多线程同时配音(例如并发线程数 >1),你的 Index-TTS 服务在同时处理多个请求时,可能因资源争抢或内部状态混乱,返回参数错误。
  • 或者 Index-TTS 后端在连续高频请求后出现临时异常,后续请求恢复正常。

解决办法

  1. 限制并发数:打开菜单 → 工具/选项 → 高级选项 → 字幕配音调整,将 并发配音线程数 设为 1,保存后重启软件。这能避免多个请求同时涌入 Index-TTS。
  2. 增加请求间隔:同样在高级选项 → 字幕配音调整,将 配音后暂停秒 设为 2-5,降低请求频率。
  3. 重启 Index-TTS 服务:关闭 Index-TTS 终端窗口,重新启动服务,确保状态重置。
  4. 在 F5-TTS/Index-TTS 设置中确认:菜单 → TTS 设置 → F5-TTS(Index-TTS 共用面板),确保未勾选情感控制相关选项。

按上述调整后,若仍间歇性出错,可尝试换用其他更稳定的配音渠道(如 Edge-TTS 免费渠道)测试。

Edge-TTS(免费)
Qwen3-TTS(本地内置)
OmniVoice(本地API)
MOSS-TTS-Nano(本地内置)
Piper(本地内置)
VITS(本地内置)
Supertonic3(本地内置)
ChatterBox(本地内置)
F5-TTS(本地API)
Index-TTS(本地API) 全部内置给我介绍一下

以下是您列出的配音渠道的简要介绍,按“免费/本地内置/本地API”分类说明:

  • Edge-TTS(免费):微软在线免费配音,无需密钥、无需部署,开箱即用。支持所有常见语言,有大量发音角色。但存在高并发限流风险,建议将并发数设为1、请求间隔设为5秒。
  • Qwen3-TTS(本地内置):阿里通义千问3.0 TTS模型,代码内置在软件中,首次使用时需联网下载模型。支持10多种语言,声音克隆需截取原视频音频片段。模型从HuggingFace/ModelScope下载。
  • MOSS-TTS-Nano(本地内置):基于MOSS的轻量级TTS,代码内置,首次需下载模型。主要支持中英文,无需额外部署服务。
  • Piper(本地内置):开源多语言TTS引擎,模型内置,首次需下载相应语言模型。支持中英日韩等多种语言,可在本地离线运行。
  • VITS(本地内置):基于VITS的语音合成模型,代码内置,首次需下载模型。支持多语言语音合成和声音克隆(需参考音频)。
  • Supertonic3(本地内置):一个内置的TTS模块,首次使用需下载模型,支持多语言。名称可能指向特定开源模型。
  • ChatterBox(本地内置):内置TTS模块,支持多语言语音克隆,首次需下载模型。无需外部部署。
  • OmniVoice(本地API)不是内置,需要在本地部署OmniVoice服务或使用已有API地址,然后在软件设置中填写API地址。支持声音克隆,可指定原视频音色。首次使用无需下载模型(由外部服务提供)。
  • F5-TTS(本地API)不是内置,需本地部署F5-TTS API服务(如使用F5-TTS的Gradio WebUI),在软件设置中填写API地址。支持中英文语音克隆,参考音频需放在f5-tts/文件夹。
  • Index-TTS(本地API)不是内置,类似F5-TTS,需部署Index-TTS的API服务,填写API地址。支持中英文克隆。

总结:Edge-TTS(免费在线)、Qwen3-TTS、MOSS-TTS-Nano、Piper、VITS、Supertonic3、ChatterBox 为“本地内置”或“免费”,无需额外部署,首次使用会自动下载模型。OmniVoice、F5-TTS、Index-TTS 必须自行部署对应的后端服务并配置API地址。

Post Your Reply
Open source and free maintenance is not easy. If this project is helpful to you, please consider making a small donation to help the project continue to maintain and update. Dondate: ko-fi.com/jianchang512

Related resource

Similar issues already exist