#2569 下载了JhonVanced--whisper-large-v3-japanese-4k模型，该如何在软件中使用？

您下载的 JhonVanced--whisper-large-v3-japanese-4k 是一个社区微调的 Whisper 模型，主要用于日语识别。要在 pyVideoTrans 中使用它，请按以下步骤操作：

1. 确认模型格式：确保您下载的模型是 faster-whisper 或 openai-whisper 兼容的格式（通常是包含 config.json、model.bin 等文件的文件夹）。

2. 放置模型文件：

   • 将整个模型文件夹（例如 JhonVanced--whisper-large-v3-japanese-4k）复制到 pyVideoTrans 的模型目录下。

   • 模型目录路径通常为：

     • Windows 预打包版：软件根目录下的 models 文件夹内（例如 D:\videotrans\models\）。
     • 源码部署版：项目根目录下的 models 文件夹。

3. 在软件中选择模型：

   • 启动 pyVideoTrans。
   • 在主界面第2行“语音识别”区域，选择识别渠道为 faster-whisper(本地)。
   • 点击“选择模型”下拉框，您应该能在列表中找到您放置的模型文件夹名称（例如 JhonVanced--whisper-large-v3-japanese-4k），选中它。
   • 将“发音语言”设置为 日语 或 ja，以确保识别引擎针对日语优化。

重要提示：

• 该模型是专门为日语优化的，在处理日语视频时效果可能优于通用 large-v3 模型，但处理其他语言可能效果不佳。
• 如果模型未出现在下拉列表中，请检查模型文件夹是否完整，并确认它位于正确的 models 目录下。
• 使用前，请确保在“高级选项”中根据您的显卡显存情况，合理设置 CUDA数据类型（如 int8 以节省显存）和 beam_size（如设为 1 以进一步减少显存占用）。

请查看更多参考文档：

• faster-whisper本地
• faster下载模型失败解决办法
• 优化语音识别精度和断句效果

在模型下拉框里没有JhonVanced--whisper-large-v3-japanese-4k模型

模型未出现在下拉框，通常是因为模型文件夹未放置在软件识别的正确路径，或者模型格式不被支持。请按以下步骤排查：

1. 确认模型放置路径：

   • Windows 预打包版：请将 JhonVanced--whisper-large-v3-japanese-4k 整个文件夹，复制到软件根目录下的 models 文件夹内。
   • 路径示例：D:\videotrans\models\JhonVanced--whisper-large-v3-japanese-4k\（里面应包含 config.json、model.bin 等文件）。
   • 重要：不要放在 models/faster-whisper 或 models/whisper 等子目录里，直接放在 models 下。

2. 检查模型完整性：

   • 打开 JhonVanced--whisper-large-v3-japanese-4k 文件夹，确认里面至少包含 config.json、model.bin（或 model.safetensors、pytorch_model.bin）等核心文件。如果只有单个文件（如 .gguf），则可能是 whisper.cpp 格式，不被 faster-whisper 直接支持。

3. 重启软件：

   • 放置好模型后，完全关闭 pyVideoTrans 再重新启动，下拉列表会重新扫描 models 目录。

4. 手动指定路径（备用方案）：

   • 如果上述步骤后仍未出现，您可以尝试：

     • 在“语音识别”设置区域，点击“选择模型”下拉框右侧的“...”（浏览）按钮（如果存在）。
     • 或者，在软件根目录下找到 config.ini 文件，用记事本打开，在 [default] 部分添加一行：whisper_model = 您的模型完整绝对路径（例如 whisper_model = D:\videotrans\models\JhonVanced--whisper-large-v3-japanese-4k），然后保存并重启软件。

如果模型格式确实是 faster-whisper 兼容的，且放置路径正确，重启后应该会出现在列表中。如果问题依旧，请提供您模型文件夹内的文件列表截图。

请查看更多参考文档：

• faster-whisper本地
• faster下载模型失败解决办法