#936 ValueError: Cannot find a function with `api_name`: /basic_tts.

206.237* Posted at: 4 months ago 👁215

无效的值或参数:Cannot find a function with api_name: /basic_tts.:

Traceback (most recent call last):

File "videotrans\util\ListenVoice.py", line 18, in run

File "videotrans\tts\__init__.py", line 293, in run

File "videotrans\tts\_base.py", line 182, in run

File "tenacity\__init__.py", line 480, in __call__

File "videotrans\tts\_f5tts.py", line 313, in _run

File "videotrans\tts\_f5tts.py", line 82, in _item_task_v1

File "gradio_client\client.py", line 475, in predict

self._infer_fn_index(api_name, fn_index)

File "gradio_client\client.py", line 831, in _infer_fn_index

raise ValueError(error_message)

ValueError: Cannot find a function with api_name: /basic_tts.

=====

Windows-10-10.0.26200-SP0

version:v3.81

frozen:True

language:zh

5 Replies

本条内容由 Gemini 回复
您遇到的 ValueError: Cannot find a function with api_name: /basic_tts. 错误,通常表示 pyVideoTrans 在尝试使用 F5TTS 进行配音时,无法连接到或找到 F5TTS 后端服务(该服务通常通过 Gradio 运行)提供的 /basic_tts API 接口。

这可能是由于以下原因:

1. F5TTS 后端服务未正常启动或已崩溃。

2. F5TTS 模型或环境配置出现问题。

请尝试以下解决方案:

1. 重启 pyVideoTrans 软件: 有时候简单的重启可以解决后台服务启动失败的问题。关闭 sp.exe 进程后重新运行。

2. 检查 F5TTS 模型文件: 如果是首次使用 F5TTS,请确保模型文件已完全下载且未损坏。虽然软件会自动处理,但网络问题可能导致下载不完整。

3. 尝试切换到其他配音渠道: 作为临时的解决方案,您可以先尝试使用其他稳定且免费的配音渠道,例如 Edge-TTS

  • 在主界面,将“配音渠道”切换为 Edge-TTS(免费)
  • 如果使用 Edge-TTS 依然频繁报错(如 403),请进入 工具/选项 -> 高级选项 -> 配音调整,将“同时配音字幕数”改为 1,并将“配音后暂停时间/秒”设为 5 或更高,以避免微软 API 限流。

4. 提供完整的日志文件: 如果上述方法未能解决问题,或者您坚持使用 F5TTS,请提供位于 videotrans/logs/ 目录下的最新日志文件(以 {年月日}.log 格式命名)。这将帮助我们更详细地分析启动 F5TTS 时的具体错误。


Application started at 2026-02-17 13:01:10

[DEBUG] 返回缓存的编解码器 Windows-264: h264_nvenc
[DEBUG] 返回缓存的编解码器 Windows-265: hevc_nvenc
First searching GPU...
Found 1 GPUs, cost=6s
start workers...
NVIDIA_GPU_NUMS=1
process_max_gpu=0
multi_gpus=False
Concurrent task_nums=1
process_max=0
start 8 jobs
ended workers
[INFO] Starting call to 'videotrans.tts._f5tts.F5TTS._item_task.._run', this is the 1st time calling it.
Loaded as API: http://127.0.0.1:7860/
[INFO] Finished call to 'videotrans.tts._f5tts.F5TTS._item_task.._run' after 0.063(s), this was the 1st time calling it.
[INFO] Starting call to 'videotrans.tts._f5tts.F5TTS._item_task.._run', this is the 2nd time calling it.
Loaded as API: http://127.0.0.1:7860/
[INFO] Finished call to 'videotrans.tts._f5tts.F5TTS._item_task.._run' after 5.125(s), this was the 2nd time calling it.
[DEBUG] [字幕配音]渠道9:共耗时:6s

根据日志,F5-TTS 服务已成功连接(Loaded as API: http://127.0.0.1:7860/),但调用其 /basic_tts 接口时失败。这通常是由于 F5-TTS 后端服务版本或配置与 pyVideoTrans 不兼容所致。

解决方案:

  1. 升级 pyVideoTrans 软件:您当前的版本是 v3.81。请先升级到最新版本 v3.97。许多与外部服务(如 F5-TTS)的兼容性问题已在后续版本中修复。
  2. 检查并重启 F5-TTS 后端服务:确保您启动的 F5-TTS 服务(例如通过运行 python app.py 或启动其整合包)是最新版本,并且其 API 接口定义与 pyVideoTrans 所调用的 /basic_tts 路径匹配。有时重启该服务可以解决临时的接口加载问题。
  3. 验证 F5-TTS 服务状态:在浏览器中访问 http://127.0.0.1:7860,确认 F5-TTS 的 WebUI 界面能正常打开且功能可用。
  4. 临时使用其他配音渠道:在问题解决前,可暂时切换到 Edge-TTS 渠道以继续工作。为避免 403 错误,请在“高级选项”中将“同时配音线程数”设为 1,“配音后暂停秒数”设为 5。

如果升级软件并重启 F5-TTS 服务后问题依旧,请提供 F5-TTS 服务启动终端的完整错误日志。

请查阅相关文档:

但调用其 /basic_tts 接口时失败。这通常是由于 F5-TTS 后端服务版本或配置与 pyVideoTrans 不兼容所致。该怎么处理,给个详细的解决方案

F5-TTS 后端服务的 API 接口路径与 pyVideoTrans 调用不匹配。需要确保 F5-TTS 服务启动时暴露了正确的 /basic_tts 接口。

请按以下步骤操作:

  1. 升级 pyVideoTrans

  2. 检查并重启 F5-TTS 服务

    • 完全关闭您正在运行的 F5-TTS 服务(命令行窗口或整合包)。
    • 重新启动 F5-TTS 服务。启动时请务必确认其启动命令或配置中包含了 /basic_tts 接口。如果您使用的是官方 F5-TTS 项目,通常启动 app.py 即可。如果您使用的是第三方整合包,请查阅其文档确认 API 路径。
  3. 验证 F5-TTS API 接口

    • 在浏览器中访问 http://127.0.0.1:7860,打开 F5-TTS 的 WebUI。
    • F12 打开开发者工具,切换到 Network (网络) 选项卡。
    • 在 WebUI 界面中尝试进行一次文本转语音的推理操作。
    • 在 Network 面板中,观察发出的请求,其 路径(Path) 应包含 /basic_tts 或类似的 API 端点。这可以确认服务端提供的接口名称。
  4. 在 pyVideoTrans 中核对配置

    • 在 pyVideoTrans 主界面,点击“配音渠道”选择框旁边的 设置 按钮(齿轮图标)。
    • 在弹出的 F5-TTS 配置窗口中,检查 API地址 是否正确(应为 http://127.0.0.1:7860/ 或您自定义的地址)。
    • 关键步骤:查看配置中是否有 “API路径/名称” 或类似的输入框。如果存在,请确保其值为 /basic_tts。如果该值为空或为其他值,请修改为 /basic_tts
  5. 临时替代方案

    • 如果以上步骤无法快速解决,建议暂时使用 Edge-TTS 渠道继续工作。
    • 在“高级选项”中,将“同时配音线程数”设为 1,“配音后暂停秒数”设为 5 或更高,以避免微软 API 的 403 限流错误。

如果完成升级和上述检查后问题仍然存在,请提供:

  1. F5-TTS 服务启动时的终端输出日志(完整截图或复制文本)。
  2. 您使用的 F5-TTS 项目来源(GitHub 链接或整合包名称)。

请查阅相关文档:

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.

Related resource