5分钟跑通whisper-large-v3-turbo-ar-quran:零基础古兰经语音转文字(ASR)快速入门指南
5分钟跑通whisper-large-v3-turbo-ar-quran:零基础古兰经语音转文字(ASR)快速入门指南
whisper-large-v3-turbo-ar-quran 是一个基于 OpenAI Whisper large-v3-turbo 微调的开源 ASR(语音识别)模型,专为古兰经阿拉伯语音转文字而生,在 EveryAyah 测试集上词错误率(WER)仅 1.18%。本文面向零基础用户,5 分钟带你跑通它 🎙️
为什么选择这个古兰经语音识别模型?
- 基座模型强大:基于 Whisper large-v3-turbo(总参数约 8.09 亿),通过 LoRA 微调(仅约 200 万可训练参数)专注阿拉伯语古兰经场景
- 训练数据专业:使用 tarteel-ai/everyayah 数据集,包含 167,908 条逐句(Ayah)古兰经诵读音频
- 精度极高:测试集 WER 1.18%、CER 0.34%,远优于通用 Whisper 在古兰经诵读上的表现
| 评测集 | 样本数 | WER(词错误率) | CER(字错误率) |
|---|---|---|---|
| 测试集(Test Split) | 23,473 | 1.18% | 0.34% |
| 验证集(Validation Split) | 20,976 | 0.86% | - |
仓库文件速览:每个文件都是干嘛的?
这个仓库是一个"开箱即用"的完整模型,主要文件如下:
| 文件 | 作用 |
|---|---|
| model.safetensors | 模型权重文件,模型能力的核心 |
| config.json | 模型结构配置(层数、注意力头数、词表大小等) |
| preprocessor_config.json | 音频前处理参数(采样率、分块长度) |
| tokenizer.json / vocab.json / merges.txt | 分词器配置与词表 |
| tokenizer_config.json / special_tokens_map.json / added_tokens.json | 特殊令牌(语言标记、转写标记等)映射 |
| normalizer.json | 文本归一化规则 |
| README.md | 模型说明、性能与训练细节文档 |
5分钟快速开始:3步转写古兰经音频
第1步:安装依赖
只需安装 transformers 和 torch:
pip install transformers torch
💡 有 NVIDIA GPU 时识别速度更快,CPU 也可运行(
device设为-1)。
第2步:转写短音频(30秒以内)
from transformers import pipeline
pipe = pipeline(
"automatic-speech-recognition",
model="naazimsnh02/whisper-large-v3-turbo-ar-quran",
device=0 # GPU
)
result = pipe("short_ayah.wav")
print(result["text"])
第3步:处理任意长度的长音频(推荐)
古兰经诵读往往较长,利用 chunk_length_s 参数让模型自动按 30 秒分块、5 秒重叠转写:
import torch
from transformers import pipeline
pipe = pipeline(
"automatic-speech-recognition",
model="naazimsnh02/whisper-large-v3-turbo-ar-quran",
device=0,
torch_dtype=torch.float16,
chunk_length_s=30, # 30秒一块
stride_length_s=5, # 块间5秒重叠,避免断句
)
result = pipe("long_quran_recitation.wav")
print(result["text"])
跑通了吗?恭喜,你已经完成了古兰经语音转文字的最小闭环 🎉
看懂关键配置:模型是怎么工作的?
- config.json 中
encoder_layers: 32、decoder_layers: 4、d_model: 1280:Whisper Turbo 的"32 层编码器 + 4 层解码器"经典瘦身结构,兼顾速度与精度 max_target_positions: 448:每 30 秒音频最多输出 448 个 token,这就是需要分块处理长音频的原因- preprocessor_config.json 中
sampling_rate: 16000:音频统一重采样为 16kHz;chunk_length: 30对应每块 30 秒
训练细节(LoRA Rank 128、学习率 5e-05、2 个 Epoch 等)可参考 README.md 的 Training Details 章节。
使用限制:哪些音频不适合?
⚠️ 在开始使用前,请务必了解边界:
- ✅ 最佳场景:正式的古兰经诵读录音(Quranic Arabic)
- ❌ 不适合:日常口语阿拉伯语、地方方言、非古兰经内容
- 🎧 音频质量:清晰、高保真的录音效果最佳,噪声大的环境精度会下降
常见问题
Q:没有 GPU 能用吗?
可以,把 device=0 改为 device=-1,速度会变慢但功能完整。
Q:转写结果带不发音的尾符或格式异常? 确认音频为古兰经诵读内容,并优先使用 16kHz 单声道、背景安静的录音。
Q:如何在项目中使用模型 ID?
代码中直接使用 naazimsnh02/whisper-large-v3-turbo-ar-quran 即可自动下载本仓库的全部文件。
登录后查看全文