#5420 语音识别阶段出错[WhisperX(本地API)] Error code: 500 - {'error': '处理过程中发生内部错误。'}Traceback (most recent call last):File "videotrans\

a'aaa

WhisperX 本地 API 服务内部出错（HTTP 500），最常见原因是 显存不足（OOM） 或 服务进程崩溃。

解决方案

1. 重启 WhisperX 服务
   找到你部署的 WhisperX 服务命令行窗口，重启它（Ctrl+C 终止后重新运行）。重启后重新提交任务。
2. 降低模型尺寸
   当前你使用了 distil-large-v3.5（约 1.5GB 参数）。如果显卡显存低于 8GB，建议改为 base 或 small 模型（在软件「语音识别」下拉框中选择）。
   distil-large-v3.5 推荐使用 NVIDIA 12GB+ 显存。
3. 检查服务端日志
   打开 WhisperX 服务端的终端窗口，查看最后出现的错误信息（如 CUDA out of memory、RuntimeError 等），根据具体报错调整配置。
4. 确认 API 地址填写正确
   在软件 菜单 → 语音识别设置 → WhisperX 中，确保 API 地址为 http://127.0.0.1:端口号（默认端口通常是 9000 或 8000），不要填写 0.0.0.0 或错误端口。
5. 若多次失败
   尝试临时切换到 faster-whisper(本地) + large-v3-turbo 模型（更稳定），等 WhisperX 环境调试好后再换回。

请查阅相关文档：

• WhisperX 语音识别渠道
• 常见问题 FAQ

WhisperX 本地 API 服务返回 HTTP 500 内部错误，通常是服务进程崩溃（显存不足、模型加载失败或代码异常）导致。

排查步骤：

1. 重启 WhisperX 服务
   在部署 WhisperX 的终端中按 Ctrl+C 停止，然后重新启动（例如 uv run whisperx_server.py 或对应的启动命令）。重启后重新提交任务。
2. 降低模型尺寸
   你当前使用 distil-large-v3.5 模型，推荐显存不低于 12GB。如果显存不足（例如 8GB 以下），请在软件的「语音识别」下拉框中切换为较小的模型，如 base 或 small。
3. 检查服务端日志
   查看 WhisperX 服务端的控制台输出，定位具体错误（常见如 CUDA out of memory、RuntimeError、FileNotFoundError）。根据日志调整配置（如限制最大音频时长、关闭某些后处理）。
4. 确认 API 地址
   确保软件内「语音识别设置 → WhisperX」中的 API 地址正确（默认 http://127.0.0.1:9000），不要填写 0.0.0.0 或错误端口。
5. 临时替代方案
   如果上述无法快速解决，可临时切换到 faster-whisper(本地) + large-v3-turbo 模型，稳定性更高，待 WhisperX 环境调通后再切换回来。

请查阅相关文档：

• WhisperX 语音识别渠道
• 常见问题 FAQ