想整理自己的教程录音,可以先从一段一分钟的清晰音频开始。faster-whisper 提供 Python 转写接口。本文依据仓库 README 的用法整理入门步骤,示例用于学习,不代表已经在你的电脑上完成安装或速度测试。

准备环境和练习文件

先核对项目当前支持的 Python 版本,在独立虚拟环境中安装依赖。把一段有权处理的音频保存为 audio.mp3,与脚本放在同一目录。先用普通话清晰独白验证流程,再尝试会议或嘈杂录音。

python -m venv .venv
# 使用当前系统对应的方法激活 .venv 后执行:
python -m pip install faster-whisper

Windows PowerShell 的激活入口通常是 .venv\Scripts\Activate.ps1;若执行策略阻止激活,可直接使用虚拟环境中的 python.exe 执行安装与脚本。不要将全局 Python 和虚拟环境混用。

用 CPU 示例输出每一段

from faster_whisper import WhisperModel

model = WhisperModel("small", device="cpu", compute_type="int8")
segments, info = model.transcribe("audio.mp3", beam_size=5)
for segment in segments:
    print(f"[{segment.start:.2f} - {segment.end:.2f}] {segment.text}")

模型首次使用可能需要下载文件,预留网络和磁盘空间。若硬件不支持示例计算类型,应按项目说明选择支持的配置。GPU 需要另外核对依赖,本篇不要求安装 GPU 环境。

为什么拿到 segments 后没有文字

返回的 segments 是生成器,迭代时才会实际进行转写。不要只检查变量是否存在;观察循环输出或将它转换为列表。录音较长时,将全部结果放入内存前也要考虑规模。

先校对内容,再做摘要

对照录音检查人名、产品名、数字和否定词。给不确定处标记时间,回听后修改。转写文本可作为笔记草稿;不要让后续摘要把识别错误扩大成确定结论。自己保存“原始结果”和“校对结果”两个版本。

常见问题

下载失败和识别失败怎么区分?

先看错误发生在模型准备、文件读取还是转写阶段。分别检查网络缓存、音频路径与依赖,保留第一条错误。

它能自动区分每个说话人吗?

本篇示例只演示带时间的文本分段,没有加入说话人分离;不能把分段编号当作说话人身份。

Windows 操作示例:从文件夹到结果文件

在桌面新建文件夹 whisper-practice,放入一段自己有权处理的短音频,命名为 audio.mp3。在这个文件夹的地址栏输入 powershell 并回车,在打开的终端依次执行:

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install faster-whisper

用记事本新建 transcribe.py,将上文的 Python 示例完整粘贴进去,保存类型选择“所有文件”,编码选择 UTF-8。确认文件名不是 transcribe.py.txt。回到同一终端执行:

.\.venv\Scripts\python.exe transcribe.py

第一次运行可能需要下载 small 模型;模型准备完成后,终端应逐段出现开始时间、结束时间和识别文字。检查时间是否从接近零开始且逐渐增加,抽两段回听纠正人名和数字。如果报找不到 audio.mp3,执行 dir 检查当前文件夹中是否真的存在该文件。

把终端结果保存下来

.\.venv\Scripts\python.exe transcribe.py > transcript.txt

转写完成后打开 transcript.txt 校对。第二次使用重定向会覆盖同名文件,已有结果请先另存。若中文显示异常,优先在编辑器中检查文件编码;控制台和编辑器使用的编码设置可能不同。

项目来源与许可

原项目:SYSTRAN/faster-whisper。许可说明:MIT,详见原仓库许可与说明。仓库与许可核验于 2026-10-31。本文为本站编写的中文导读与练习设计,不是原教程逐字翻译;未在读者环境执行,运行结果需自行核对。