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

51 lines
1.7 KiB
Markdown

# OpenLess 火山 ASR 配置
1. 登录火山引擎
<https://console.volcengine.com/auth/login/>
![登录火山引擎](./images/volcengine-setup/01-login.png)
2. 创建旧版应用
创建时勾选 `豆包流式语音识别模型2.0 小时版`
<https://console.volcengine.com/speech/app?opt=create>
![创建旧版应用并勾选小时版](./images/volcengine-setup/02-create-legacy-app.png)
3. 打开豆包流式语音识别模型 2.0 管理页
`APP ID` 和 `Access Token` 在页面最下方
<https://console.volcengine.com/speech/service/10038?AppID=&opt=create>
![流式语音识别模型 2.0 管理页](./images/volcengine-setup/03-streaming-asr-page.png)
4. 复制到 OpenLess 的 `Settings` 页面
打开:
`Settings -> Providers -> ASR`
![复制到 OpenLess 的 Settings 页面](./images/volcengine-setup/04-openless-settings.png)
填这两个:
- `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>