OpenAI Whisper 语音转文本实战指南
如果你需要将语音内容快速转换为可编辑的文字，OpenAI Whisper 是目前非常值得尝试的开源方案。作为当前领先的语音识别模型之一，它支持多语言自动识别，无需付费订阅即可在本地或服务器部署，特别适合个人开发者及中小团队集成到工作流中。
环境准备与安装
在开始之前，确保你的开发环境满足以下基础要求：
- Python 3.8 或更高版本
- FFmpeg（用于音频处理）
- 足够的磁盘空间（基础模型约占用 2.4GB）
使用 pip 安装必要的依赖包。注意，Whisper 基于 PyTorch，因此需要同时安装 torch 及其相关组件：
pip install openai-whisper transformers torch torchvision torchaudio
基础转录实现
对于短音频文件，直接使用 Hugging Face Transformers 库加载预训练模型是最便捷的方式。这里以 openai/whisper-base.en 为例，该模型针对英语优化，但官方也提供了多语言版本。
from transformers import WhisperProcessor, WhisperForConditionalGeneration
# 加载处理器和模型
processor = WhisperProcessor.from_pretrained("openai/whisper-base.en")
model = WhisperForConditionalGeneration.from_pretrained("openai/whisper-base.en")
# 读取并预处理音频文件
audio_file = "your_recording.wav"
input_features = processor(audio_file, return_tensors="pt").input_features
# 生成文本
predicted_ids = model.generate(input_features)
transcription = processor.batch_decode(predicted_ids, skip_special_tokens=True)[0]
print(transcription)
这段代码的核心在于利用 processor 将音频波形转换为模型可理解的张量，再通过 generate 方法解码为文本。实际运行时，如果音频采样率不符合要求，建议先统一调整为 16kHz。
长音频与批量处理策略
当面对超过 30 秒的长录音时，直接输入可能会导致显存溢出或精度下降。此时推荐使用 Pipeline 接口配合分块处理，或者自行实现多线程批量任务。
分块处理
Pipeline 模式简化了代码结构，且内置了对长音频的分段逻辑：
from transformers import pipeline
# 创建语音识别管道，设置分块长度
speech_recognizer = pipeline(
"automatic-speech-recognition",
model="openai/whisper-base.en",
chunk_length_s=30
)
# 处理完整音频
result = speech_recognizer()
(result[])
