火山引擎（豆包语音）

本指南用于开通豆包语音识别，并将凭证填入 VoicePaste；不是豆包聊天应用或语音合成服务的配置说明。

以下截图沿用旧版指南，界面布局可能与当前版本略有不同，请按字段名称操作。点击图片可查看原图。

1. 开通语音识别服务复制标题链接

1. 登录 豆包语音控制台的开通管理。

2. 在当前项目中找到「流式语音识别 2.0」，按控制台提示开通。

   

3. 检查服务状态和可用额度。费用、试用额度及是否需要充值，以当前控制台为准。

2. 创建 API Key复制标题链接

1. 打开 API Key 管理。

2. 确认选中开通服务的同一个项目，再创建或获取 API Key。

   

3. 保存密钥，用于下一步配置。不同项目的密钥和资源不能混用。

3. 填入 VoicePaste复制标题链接

1. 打开「设置 → 音频模型 → 在线模型」，找到火山引擎的豆包流式语音识别模型。

2. 在参数配置中填写 API Key。如果已有旧版凭证并显示「鉴权方式」，切换为「新版」。

3. 保留其他参数的默认值，保存配置并启用模型。

   

4. 在输入框中录制一句话，确认文字输出。

已有旧版凭证时复制标题链接

旧版账户可以使用 App ID 和 Access Token。新用户优先使用前面的 API Key 方式，无需同时填写两套凭证。

1. 在 旧版豆包语音控制台 创建或选择应用，接入能力选择「豆包流式语音识别模型 2.0 小时版」。

   

2. 进入对应模型，选择应用并开通服务，获取该应用的 App ID 和 Access Token。

   

3. 在 VoicePaste 的模型参数中选择「旧版」鉴权，填写对应凭证并保存。

   

热词与更多参数复制标题链接

• 本地热词：按 热词库 创建并启用词组。
• 在线热词表：在 热词管理 创建词表，再把词表 ID 填入模型的「热词表 ID」。
• 在线替换表：在 替换词管理 创建后，把 ID 填入「替换表 ID」。
• 其他参数：确认基本识别可用后再调整；语言和方言支持随接口模式而异，不能直接套用其他接口的能力。

常见问题复制标题链接

服务未开通怎么办？复制标题链接

回到开通管理，确认当前项目的「流式语音识别 2.0」已开通。

密钥和项目不匹配怎么办？复制标题链接

确认 API Key 与识别服务属于同一项目；不同项目的密钥和资源不能混用。

鉴权失败怎么办？复制标题链接

检查凭证是否完整、鉴权方式是否匹配：新版使用 API Key，旧版使用 App ID 和 Access Token。请勿把完整密钥放进截图或错误反馈中。

额度不足或网络连接失败怎么办？复制标题链接

在控制台检查账户额度和服务用量，再检查网络能否连接识别服务。

官方参考：控制台指引 · 语音识别接口