当前位置：首页 > news >正文

FireRedASR-AED-L实现Python语音识别：从音频到文本的完整教程

news 2026/7/30 8:03:25

FireRedASR-AED-L实现Python语音识别：从音频到文本的完整教程

1. 引言

语音识别技术正在改变我们与设备交互的方式，从智能助手到实时字幕，这项技术已经深入到日常生活的方方面面。今天我要介绍的FireRedASR-AED-L，是一个专门为中文普通话优化的开源语音识别模型，它在保持高精度的同时，还能很好地支持英文识别。

这个教程的目标很简单：让你能在自己的Python环境中快速搭建一个可用的语音识别系统。不需要深厚的机器学习背景，只要会写基本的Python代码，跟着步骤走，一两个小时就能看到效果。

我会从最基础的环境配置开始，带你一步步完成音频预处理、模型调用、结果处理的全过程。每个步骤都有详细的代码示例，你可以直接复制使用。学完这篇教程，你就能在自己的项目中集成语音转文字功能了。

2. 环境准备与快速部署

2.1 系统要求与依赖安装

首先确保你的系统满足这些基本要求：

Python 3.8或更高版本
至少8GB内存（处理长音频时需要更多）
支持CUDA的GPU（可选，但能显著加速）

打开终端，按顺序执行以下命令：

# 克隆项目仓库 git clone https://github.com/FireRedTeam/FireRedASR.git cd FireRedASR # 创建Python虚拟环境 python -m venv asr_env source asr_env/bin/activate # Linux/Mac # 或者使用 asr_env\Scripts\activate # Windows # 安装依赖包 pip install -r requirements.txt

这个过程可能会花几分钟时间，取决于你的网络速度。如果遇到权限问题，可以在命令前加上sudo（Linux/Mac）或以管理员身份运行终端（Windows）。

2.2 模型文件准备

FireRedASR-AED-L的模型文件需要从Hugging Face下载：

# 创建模型存储目录 mkdir -p pretrained_models/FireRedASR-AED-L # 下载模型文件（约2.5GB） # 可以从Hugging Face页面手动下载或使用huggingface_hub库 python -c " from huggingface_hub import snapshot_download snapshot_download(repo_id='FireRedTeam/FireRedASR-AED-L', local_dir='pretrained_models/FireRedASR-AED-L') "

如果下载速度慢，可以考虑使用国内镜像源或者预先下载好模型文件放到指定目录。

3. 音频预处理基础

3.1 音频格式要求

FireRedASR-AED-L对输入音频有特定要求，不符合格式的音频需要先转换：

采样率：16000Hz
声道数：单声道
编码格式：16-bit PCM WAV

如果你的音频不符合这些要求，可以用FFmpeg进行转换：

# 安装FFmpeg（如果尚未安装） # Ubuntu: sudo apt install ffmpeg # Mac: brew install ffmpeg # Windows: 从官网下载安装包 # 转换音频格式 ffmpeg -i input_audio.mp3 -ar 16000 -ac 1 -acodec pcm_s16le output.wav

3.2 Python音频处理

你也可以用Python库来处理音频文件：

import librosa import soundfile as sf def convert_audio(input_path, output_path): # 加载音频文件 audio, sr = librosa.load(input_path, sr=16000, mono=True) # 保存为16-bit PCM WAV格式 sf.write(output_path, audio, 16000, subtype='PCM_16') print(f"音频转换完成：{output_path}") # 使用示例 convert_audio("my_audio.mp3", "converted_audio.wav")

这个函数会自动处理采样率和声道转换，确保音频符合模型要求。

4. 快速上手示例

4.1 最简单的语音识别

让我们从一个最简单的例子开始，识别单个音频文件：

from fireredasr.models.fireredasr import FireRedAsr # 初始化模型 model = FireRedAsr.from_pretrained("aed", "pretrained_models/FireRedASR-AED-L") # 准备音频文件 audio_file = "converted_audio.wav" # 执行语音识别 results = model.transcribe( ["test_audio"], # 音频ID，可以自定义 [audio_file], # 音频文件路径 { "use_gpu": 1, # 使用GPU加速 "beam_size": 3, # 搜索宽度，影响识别精度 "nbest": 1 # 返回最佳结果 } ) print("识别结果：", results[0]["text"])

第一次运行时会加载模型，可能需要一两分钟。之后再次识别就会快很多。

4.2 批量处理多个文件

如果你有多个音频文件需要处理，可以这样批量处理：

import os def batch_transcribe(audio_folder): # 获取所有WAV文件 audio_files = [f for f in os.listdir(audio_folder) if f.endswith('.wav')] # 准备批处理数据 utt_ids = [f"audio_{i}" for i in range(len(audio_files))] wav_paths = [os.path.join(audio_folder, f) for f in audio_files] # 批量识别 results = model.transcribe( utt_ids, wav_paths, { "use_gpu": 1, "beam_size": 3, "nbest": 1, "batch_size": 4 # 根据GPU内存调整批处理大小 } ) # 输出结果 for i, result in enumerate(results): print(f"{audio_files[i]}: {result['text']}") # 使用示例 batch_transcribe("audio_samples")

5. 实用技巧与进阶功能

5.1 调整识别参数

模型提供了一些参数可以调整识别效果：

# 高级参数配置 advanced_config = { "use_gpu": 1, "beam_size": 5, # 增大搜索宽度，提高精度但更慢 "nbest": 3, # 返回3个最佳结果 "decode_max_len": 0, # 最大解码长度，0表示无限制 "softmax_smoothing": 1.0, # 平滑参数 "aed_length_penalty": 0.0, # 长度惩罚 "eos_penalty": 1.0 # 结束符惩罚 } results = model.transcribe(["audio_id"], ["audio.wav"], advanced_config)

对于中文语音，beam_size设为3-5之间通常效果不错。如果识别速度太慢，可以适当减小这个值。

5.2 处理长音频

FireRedASR-AED-L对输入长度有限制（最长60秒），处理长音频时需要分段：

from pydub import AudioSegment def split_long_audio(input_path, chunk_length=60000): # 60秒 audio = AudioSegment.from_wav(input_path) chunks = [] # 按时间分段 for i in range(0, len(audio), chunk_length): chunk = audio[i:i + chunk_length] chunk_path = f"chunk_{i//1000}s.wav" chunk.export(chunk_path, format="wav") chunks.append(chunk_path) return chunks # 分段识别长音频 long_audio = "long_recording.wav" chunks = split_long_audio(long_audio) all_results = [] for chunk in chunks: result = model.transcribe([chunk], [chunk], {"use_gpu": 1, "beam_size": 3}) all_results.append(result[0]["text"]) full_text = " ".join(all_results) print("完整识别结果：", full_text)