火山引擎 ASR 配置——默认推荐的流式语音识别方案
为什么推荐火山引擎
OpenLess 默认把火山引擎 bigasr 作为 ASR 首选,几个原因:
- 流式识别——边录边转写,延迟低,和 OpenLess 的流式工作流完美配合
- 国内网络优化——字节跳动的豆包语音服务在国内有大量节点,网络延迟低
- 价格友好——国内 ASR 提供商中性价比很高
- 热词支持完善——完全支持
context.hotwords,和 OpenLess 词典系统无缝配合 - ASR 质量稳定——中文识别准确率高,同音字处理较好
火山引擎两种服务形态
| 服务形态 | 说明 | 适用场景 |
|---|---|---|
| 普通服务(Standard) | 传统的 bigasr 流式识别 | 绝大多数用户,价格低、配置简单 |
| Agent Plan | 新出的套餐,API 结构不同 | 用 Agent Plan 套餐的用户,用专属 API Key 替代多字段鉴权 |
普通服务配置步骤
前置:在火山控制台开通
- 登录火山引擎控制台
- 搜索「豆包语音」或「语音识别」,开通大模型流式语音识别服务
- 创建一个应用,拿到三个凭据:
| 字段 | 在哪找 |
|---|---|
| App ID | 应用管理页面 |
| Access Token | 应用详情页 |
| Resource ID | 资源管理页面 |
在 OpenLess 里配置
打开 OpenLess → 设置 → AI 服务与模型 → 语音识别 → 添加渠道:
- 提供商选「火山引擎」
- 服务选择「普通服务」
- 填入 App ID、Access Token、Resource ID
- 保存
- 点「验证」——成功的话会显示 ✓ 和验证时间
Agent Plan 配置
如果你用的是火山引擎 Agent Plan 套餐,OpenLess 里选择「Agent Plan」而不是普通服务:
- 只需要一个 API Key(Agent Plan 用专属 API Key 鉴权,不需要 APP ID + Access Token + Resource ID 这一堆)
- 端点不同:
wss://openspeech.bytedance.com/api/v3/plan/sauc/bigmodel_async
Agent Plan 和普通服务建议分开创建渠道——不要在同一个渠道里切换服务类型。
端点与鉴权细节
普通服务使用的 WebSocket 端点:
wss://openspeech.bytedance.com/api/v3/sauc/bigmodel_async
Agent Plan 使用的 WebSocket 端点:
wss://openspeech.bytedance.com/api/v3/plan/sauc/bigmodel_async
OpenLess Core(Rust 后端)管理全部端点和鉴权逻辑——你只需要填凭据。
排错
| 问题 | 排查 |
|---|---|
| 验证失败 | 检查三个字段有没有填错、火山控制台里的服务状态、账号有没有欠费 |
| 录音时识别结果为空 | 检查是不是选对了普通服务 vs Agent Plan |
| 弱网时识别断续 | 火山引擎 ASR 的 WebSocket 连接有自动重试 |