从0开始学大模型：通义千问2.5-7B手把手教学
2026/1/16 6:02:32
从音频到文本+情感标签｜SenseVoice Small镜像完整使用教程
1. 学习目标与前置知识
本文旨在为开发者和技术爱好者提供一份完整的SenseVoice Small镜像使用指南，帮助您快速掌握如何通过该模型实现语音转文字、情感识别和事件标签检测。完成本教程后，您将能够：
- 熟练部署并运行 SenseVoice WebUI
- 上传音频文件或使用麦克风进行实时识别
- 获取包含文本、情感标签和事件标签的结构化输出
- 掌握提升识别准确率的关键技巧
前置知识要求
- 具备基础 Linux 操作能力（如执行 shell 命令）
- 了解基本的语音处理概念（采样率、音频格式等）
- 能够访问本地或远程 JupyterLab 环境
提示：本镜像已预装所有依赖项，无需手动安装 Python 包或下载模型权重。
2. 环境准备与服务启动
2.1 启动方式选择
根据您的使用场景，有两种方式启动 SenseVoice WebUI 服务：
方式一：开机自动启动（推荐）
系统默认配置为开机自启 WebUI 服务，适用于长期运行的服务模式。若服务未正常运行，请参考下文重启指令。
方式二：手动重启服务
进入 JupyterLab 后，在终端中执行以下命令以重启应用：
/bin/bash /root/run.sh此脚本会自动拉起 FastAPI 后端与 Gradio 前端界面，并监听7860端口。
2.2 访问 WebUI 界面
服务启动成功后，在浏览器地址栏输入：
http://localhost:7860即可打开 SenseVoice WebUI 主页面。若在远程服务器上运行，请确保防火墙开放对应端口并正确配置 SSH 隧道或反向代理。
注意：首次加载可能需要 10–20 秒时间初始化模型，后续请求响应速度显著加快。
3. 界面功能详解
3.1 页面布局说明
WebUI 采用简洁直观的双栏布局设计，左侧为操作区，右侧为示例引导区：
┌─────────────────────────────────────────────────────────┐ │ [紫蓝渐变标题] SenseVoice WebUI │ │ webUI二次开发 by 科哥 | 微信：312088415 │ ├─────────────────────────────────────────────────────────┤ │ 📖 使用说明 │ ├──────────────────────┬──────────────────────────────────┤ │ 🎤 上传音频 │ 💡 示例音频 │ │ 🌐 语言选择 │ - zh.mp3 (中文) │ │ ⚙️ 配置选项 │ - en.mp3 (英文) │ │ 🚀 开始识别 │ - ja.mp3 (日语) │ │ 📝 识别结果 │ - ko.mp3 (韩语) │ └──────────────────────┴──────────────────────────────────┘各模块功能如下：
| 图标 | 功能模块 | 说明 |
|---|---|---|
| 🎤 | 上传音频 | 支持拖拽上传或点击选择文件，也可调用麦克风录音 |
| 🌐 | 语言选择 | 可指定语言或启用自动检测（auto） |
| ⚙️ | 配置选项 | 展开高级参数设置，一般保持默认即可 |
| 🚀 | 开始识别 | 触发语音识别流程 |
| 📝 | 识别结果 | 显示最终输出文本及标签信息 |
4. 使用步骤详解
4.1 步骤一：上传音频文件或录音
方法 A：上传本地音频文件
支持主流音频格式，包括： -.mp3-.wav-.m4a-.flac-.ogg
操作流程： 1. 点击🎤 上传音频或使用麦克风区域 2. 在弹出窗口中选择目标音频文件 3. 等待上传完成（进度条显示）
方法 B：使用麦克风实时录音
适合快速测试或短句录入： 1. 点击右侧麦克风图标 2. 浏览器请求权限时点击“允许” 3. 点击红色圆形按钮开始录制 4. 再次点击停止录制，音频将自动载入
建议：录音环境应尽量安静，避免背景噪音干扰识别效果。
4.2 步骤二：选择识别语言
点击🌐 语言选择下拉菜单，可选语言包括：
| 语言代码 | 语言类型 | 推荐使用场景 |
|---|---|---|
auto | 自动检测 | 多语种混合、不确定语种时首选 |
zh | 中文普通话 | 标准中文语音 |
yue | 粤语 | 广东话、港澳地区口语 |
en | 英语 | 英美发音均可 |
ja | 日语 | Nihongo 识别 |
ko | 韩语 | Korean speech |
nospeech | 无语音 | 用于静音段落标记 |
推荐策略： - 已知语种明确 → 直接选择对应语言，提高精度 - 方言/口音较重 → 使用auto更鲁棒 - 多语言交替对话 → 必须使用auto
4.3 步骤三：开始识别
点击🚀 开始识别按钮后，系统将执行以下流程：
- 音频解码 → 统一转换为 16kHz 单声道 WAV
- VAD（Voice Activity Detection）分割有效语音段
- 调用 SenseVoice Small 模型进行 ASR + Emotion + Event 多任务推理
- 输出带标签的结构化文本
识别耗时参考
| 音频时长 | 平均处理时间（CPU/GPU混合） |
|---|---|
| 10 秒 | 0.5 – 1 秒 |
| 30 秒 | 2 – 3 秒 |
| 1 分钟 | 3 – 5 秒 |
实际性能受硬件资源影响较大，GPU 加速可显著缩短延迟。
4.4 步骤四：查看识别结果
识别完成后，结果将在📝 识别结果文本框中展示，包含三个核心部分：
（1）事件标签（Event Tags）
位于文本开头，表示非语言声音事件：
| 符号 | 含义 | 对应英文标签 |
|---|---|---|
| 🎼 | 背景音乐 | BGM |
| 👏 | 掌声 | Applause |
| 😀 | 笑声 | Laughter |
| 😭 | 哭声 | Cry |
| 🤧 | 咳嗽/喷嚏 | Cough/Sneeze |
| 📞 | 电话铃声 | Ringtone |
| 🚗 | 引擎声 | Engine |
| 🚶 | 脚步声 | Footsteps |
| 🚪 | 开门声 | Door Open |
| 🚨 | 警报声 | Alarm |
| ⌨️ | 键盘敲击 | Keyboard |
| 🖱️ | 鼠标点击 | Mouse Click |
（2）文本内容（Transcribed Text）
ASR 生成的文字内容，经过逆文本正则化（ITN）处理，数字、单位等已转换为自然表达形式。
（3）情感标签（Emotion Tags）
位于文本末尾，反映说话人情绪状态：
| 表情符号 | 情感类别 | 英文标签 |
|---|---|---|
| 😊 | 开心 | HAPPY |
| 😡 | 生气/激动 | ANGRY |
| 😔 | 伤心 | SAD |
| 😰 | 恐惧 | FEARFUL |
| 🤢 | 厌恶 | DISGUSTED |
| 😮 | 惊讶 | SURPRISED |
| （无表情） | 中性 | NEUTRAL |
5. 示例演示与结果分析
5.1 中文日常对话示例
输入音频：zh.mp3（来自示例库）
输出结果：
👏😊大家新年快乐！祝你们身体健康，万事如意！😊解析： - 事件：👏 掌声 - 文本：大家新年快乐！祝你们身体健康，万事如意！ - 情感：😊 开心（首尾均有标注）
5.2 多事件复合场景示例
输入音频：rich_1.wav
输出结果：
🎼😀欢迎收听本期节目，我是主持人小明。😊解析： - 事件：🎼 背景音乐 + 😀 笑声 - 文本：欢迎收听本期节目，我是主持人小明。 - 情感：😊 开心
5.3 情感变化识别示例
输入音频：emo_1.wav
输出结果：
😔最近工作压力真的很大…… 😰有时候晚上都睡不着觉。😔解析： - 文本描述负面情绪累积过程 - 情感标签连续标注为 😔 和 😰，体现悲伤与焦虑交织
6. 高级配置与优化建议
6.1 配置选项说明
展开⚙️ 配置选项可调整以下参数：
| 参数名 | 说明 | 默认值 |
|---|---|---|
language | 识别语言 | auto |
use_itn | 是否启用逆文本正则化（如“2025年”代替“二零二五年”） | True |
merge_vad | 是否合并相邻语音片段 | True |
batch_size_s | 动态批处理最大时长（秒） | 60 |
一般情况下无需修改，默认配置已针对大多数场景优化。
6.2 提升识别质量的最佳实践
（1）音频质量建议
| 指标 | 推荐值 |
|---|---|
| 采样率 | ≥ 16kHz |
| 位深 | 16-bit 或以上 |
| 声道 | 单声道优先（节省计算） |
| 文件格式 | WAV > MP3 > M4A（压缩损失依次增加） |
| 最佳时长 | ≤ 30 秒（长音频建议分段处理） |
（2）环境控制建议
- 尽量在安静环境中录制
- 使用指向性麦克风减少环境噪声拾取
- 避免回声严重的空旷房间
- 保持适中语速（每分钟 180–220 字）
（3）语言选择策略
| 场景 | 推荐设置 |
|---|---|
| 单一口音标准语 | 明确选择语言代码（如zh） |
| 方言/地方口音 | 使用auto自动检测更稳定 |
| 中英夹杂交流 | 必须使用auto |
| 完全无声段落 | 手动标记为nospeech |
7. 常见问题与解决方案
Q1: 上传音频后无反应？
可能原因： - 文件损坏或格式不支持 - 浏览器缓存异常 - 服务进程卡死
解决方法： 1. 尝试更换其他音频文件测试 2. 刷新页面或更换浏览器（推荐 Chrome/Firefox） 3. 重新执行/bin/bash /root/run.sh重启服务
Q2: 识别结果不准确？
排查方向： - 检查音频清晰度：是否存在爆音、失真、低音量 - 确认语言选择是否匹配实际语种 - 查看是否有强烈背景噪音（空调、风扇等）
改进措施： - 使用专业降噪工具预处理音频（如 Adobe Audition、Audacity） - 在安静环境下重新录制 - 启用auto模式尝试更灵活的语言判断
Q3: 识别速度慢？
性能瓶颈分析： - CPU 占用过高 → 影响并发处理能力 - 内存不足 → 导致频繁交换（swap） - 音频过长 → 单次处理时间线性增长
优化建议： - 分割长音频为 30 秒以内片段并批量提交 - 若支持 GPU，确认 CUDA 驱动正常加载 - 关闭不必要的后台进程释放资源
Q4: 如何复制识别结果？
点击📝 识别结果文本框右侧的「复制」按钮（📋），即可将完整输出内容复制到剪贴板，便于后续粘贴至文档或代码中。
8. 总结
8. 总结
本文全面介绍了SenseVoice Small镜像的部署、使用与优化全过程，涵盖从环境启动到结果解析的每一个关键环节。通过本教程，您已掌握以下核心技能：
- 快速部署能力：能够在 JupyterLab 或本地环境中一键启动 WebUI 服务；
- 多模态识别理解：不仅获取文本转录，还能提取情感倾向与声音事件标签；
- 工程化应用思维：学会根据实际场景选择语言模式、优化音频输入质量；
- 问题诊断能力：面对常见故障能迅速定位并恢复服务。
SenseVoice Small 凭借其轻量化设计与强大的多任务识别能力，特别适用于客服质检、心理评估辅助、智能会议纪要、内容审核等场景。结合自动化脚本，还可实现批量语音文件离线处理，构建完整的语音智能流水线。
未来可进一步探索： - 将识别结果接入数据库或可视化平台 - 结合 LLM 进行语义摘要与意图分析 - 构建定制化情感分类规则引擎
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。