常见问题 ❓
安装使用过程问题汇总
安装
使用 gpu
显卡
解决方法
参考配置
logs
nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2024 NVIDIA Corporation
Built on Thu_Jun__6_02:18:23_PDT_2024
Cuda compilation tools, release 12.5, V12.5.82
Build cuda_12.5.r12.5/compiler.34385749_0
Sat Jul 12 14:42:54 2025
+---------------------------------------------------------------------------------------+
| NVIDIA-SMI 560.35.03 Driver Version: 560.35.03 CUDA Version: 12.6 |
|---------------------------------------+------------------------+----------------------+
| GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC |
| Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. |
| | | MIG M. |
|=======================================+========================+======================|
| 0 Tesla T4 Off | 00000000:00:04.0 Off | 0 |
| N/A 39C P8 9W / 70W | 1MiB / 15360MiB | 0% Default |
| | | N/A |
+---------------------------------------+------------------------+----------------------+
| 1 Tesla T4 Off | 00000000:00:05.0 Off | 0 |
| N/A 41C P8 9W / 70W | 1MiB / 15360MiB | 0% Default |
| | | N/A |
+---------------------------------------+------------------------+----------------------+
参考版本
bash
pip install torch==2.6.0+cu124 torchvision==0.21.0+cu124 torchaudio==2.6.0+cu124 --extra-index-url https://download.pytorch.org/whl/cu124
安装 Cython
pynini
报错
解决方法
bash
conda install -c conda-forge Cython==3.0.12
conda install -c conda-forge pynini==2.1.5
或
bash
conda config --add channels conda-forge
conda install Cython==3.0.12
conda install pynini==2.1.5
使用
启动报错
使用方式
- 启动报错
RuntimeError: this license key is expired
,请尝试强制更新
bash
python cli.py update --force
- 启动报错
RuntimeError: [WinError 10060]...(1:11076)
,请尝试重新启动
bash
python cli.py start
- Windows 直接双击
start.bat
运行
界面语言切换
目前仅支持中英,添加 ?lang=
参数,逐步适配中...
使用方式
配音语言配置
默认内置10种语言,支持自定义添加节点
使用方式
json
{
"base": {
"popular_locales": [
{
"name": "中国",
"locale": "zh-CN",
"country": "China",
"enable": true
}
]
}
// ...
}
模型
模型下载失败
解决方法
log
An error occured while synchronizing the model Systran/faster-whisper-large-v3 from the Hugging Face Hub:
An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the
specified revision on the local disk. Please check your internet connection and try again.
Trying to load the model directly from the local cache, if it exists.
说话人调用错误
解决方法
log
2025-04-18 07:29:31.094 | INFO whisper_.py:102 - Loading Speaker model on device cuda
2025-04-18 07:29:31.865 | ERROR whisper_.py:106 - Error: 401 Client Error: Unauthorized for url: https://hf-mirror.com/pyannote/speaker-diarization-3.1/resolve/main/config.yaml (Request ID: Root=1-6801ff5b-0270fbd846adbc761e229ace;fddee4c5-7f49-4739-bba3-42cbc47dca6e)
- 前往并接受
pyannote/segmentation-3.0
的用户协议 - 接受
pyannote/speaker-diarization-3.1
的用户协议 - 前往并获取访问令牌:
huggingface.co/settings/tokens