Files
openless/docs/volcengine-setup.md
T
Chris233 d961248210 fix(asr): 火山 ApiKey 模式改用官方端点,修复 45000010 (#931) (#936)
* fix(asr): 火山 ApiKey 模式改用官方端点,修复 45000010 (#931)

ApiKey 鉴权模式此前使用 wss://openspeech.bytedance.com/api/v3/plan/sauc/bigmodel_async,官方文档(docs/6561/1354869)中不存在 /plan/ 路径,导致服务端鉴权层返回 45000010 AuthenticationError(The API key or AK/SK in the request is missing or invalid)。

- 端点改为与 AppIdToken 模式一致的官方双向流式优化版端点 wss://openspeech.bytedance.com/api/v3/sauc/bigmodel_async
- 按官方鉴权表补充 X-Api-Request-Id(复用会话 connect_id)与 X-Api-Sequence(固定 -1)头
- 测试断言两模式端点一致并覆盖新增请求头

* docs(asr): 补充新版控制台 API Key 配置说明,澄清 Key 来源

- docs/volcengine-setup.md 新增「新版控制台(API Key 方式)」章节(官方链接 console.volcengine.com/speech/new/setting/apikeys)
- 设置页文案不再称「方舟 API Key」,改为「新版控制台 API Key」并在提示中给出官方创建入口(en/ja/ko/zh-CN/zh-TW 同步)

* fix(asr): use fresh request IDs for connection retries
2026-08-09 17:58:26 +08:00

1.7 KiB

OpenLess 火山 ASR 配置

  1. 登录火山引擎
    https://console.volcengine.com/auth/login/

    登录火山引擎

  2. 创建旧版应用
    创建时勾选 豆包流式语音识别模型2.0 小时版
    https://console.volcengine.com/speech/app?opt=create

    创建旧版应用并勾选小时版

  3. 打开豆包流式语音识别模型 2.0 管理页
    APP ID 和 Access Token 在页面最下方
    https://console.volcengine.com/speech/service/10038?AppID=&opt=create

    流式语音识别模型 2.0 管理页

  4. 复制到 OpenLess 的 Settings 页面

    打开:

    Settings -> Providers -> ASR

    复制到 OpenLess 的 Settings 页面

    填这两个:

    • APP ID
    • Access Token

    不用填:

    • Secret Key

新版控制台(API Key 方式)

新版豆包语音控制台统一使用单个 API Key 鉴权,无需 APP ID / Access Token(旧版应用方式见上文)。

  1. 在新版语音控制台创建 API Key
    https://console.volcengine.com/speech/new/setting/apikeys

  2. 在 OpenLess 的 Settings -> Providers -> ASR 中:

    • 鉴权模式选择「新版控制台 API Key」
    • 填入上一步创建的 API Key
    • Resource ID 保持默认 volc.seedasr.sauc.duration(豆包流式语音识别模型 2.0 · 小时版)

新旧两种模式共享同一 WebSocket 端点(wss://openspeech.bytedance.com/api/v3/sauc/bigmodel_async),仅握手鉴权头不同(新版为 X-Api-Key 单头)。官方接口文档:https://www.volcengine.com/docs/6561/1354869