Whisper 模型跨平台下载与部署指南
1. 环境准备
- Python 安装:
- Windows:从官网下载安装包,勾选
Add Python to PATH
- Windows:从官网下载安装包,勾选
- FFmpeg 安装(音频处理必需):
- Windows:下载预编译包,解压后添加
bin目录到系统PATH - Mac:
brew install ffmpeg - Linux:
sudo apt install ffmpeg
- Windows:下载预编译包,解压后添加
Linux/Mac:终端执行:
# Linux
sudo apt update && sudo apt install python3 pip
# Mac
brew install python
2. 安装 Whisper
所有平台统一命令:
pip install -U openai-whisper
3. 模型下载
- 手动下载(解决网络问题):
- 从 Hugging Face 仓库下载模型:https://huggingface.co/openai
- 将模型文件放入缓存目录:
- Linux/Mac:
~/.cache/whisper - Windows:
C:\Users\<用户名>\.cache\whisper
- Linux/Mac:
自动下载(首次运行时自动获取):
whisper audio.mp3 --model base
4. 基本使用
Python API:
import whisper
model = whisper.load_model("base")
result = model.transcribe("audio.mp3", fp16=False) # CPU 模式
print(result["text"])
命令行转录:
whisper input.mp3 --language en --model medium
输出文件:input.mp3.txt(文本)、input.mp3.srt(字幕)

