OpenLess 讯飞 ASR 配置

OpenLess 支持讯飞开放平台的实时语音转写（RTASR，标准版），用于把录音实时转写成文字。

所需服务

• 服务：讯飞开放平台 实时语音转写（标准版）
• 接口文档：https://www.xfyun.cn/doc/asr/rtasr/API.html

说明：录音文件转写（IFASR）、实时语音转写大模型（202 方言 / 37 语种免切）目前 未接入。若你有这些需求，欢迎在 issue #842 留言。

凭证获取

1. 登录讯飞开放平台：https://www.xfyun.cn/
2. 控制台 → 我的应用 → 创建应用，添加 实时语音转写 服务（需先在服务页领取免费额度或购买）。
3. 在服务管理页查看并复制 AppID 与 API Key。
4. 打开 OpenLess Settings → Providers → ASR，选择「讯飞实时语音转写」，填入 AppID 与 API Key。

音频约束

• 采样率 16 kHz、位深 16 bit、单声道 PCM（与 OpenLess 录音输出完全一致，无需转码）。
• 支持中文普通话、中英混合与英文；方言/小语种需在讯飞控制台开通后由 lang 参数指定， 首期 OpenLess 固定使用中文普通话（lang=cn）。
• IP 白名单：若在讯飞控制台开启了 IP 白名单，请把运行 OpenLess 机器的公网 IP 加入， 否则握手会返回 10105 illegal access。

已知限制

• 标准版 RTASR 没有请求参数级热词：OpenLess 的词典热词不会传给讯飞，个性化热词 请在讯飞控制台上传。
• 实时出字由服务端驱动：OpenLess 的胶囊 UI 在收尾阶段一次性展示最终文本（与其它 流式 provider 行为一致）。

排障

• 10105 / 10110：AppID / API Key 错误、IP 白名单未放行，或账号未开通实时语音转写服务。
• 10800：超过授权连接数（并发路数已满）。
• 37005：超过 15 秒未发送音频（弱网时偶发，可重试）。