豆包云端 TTS：申请与配置
在火山引擎申请豆包语音 API Key，并在 Origo X 中配置、试听和开始听书。
本页目录
豆包云端 TTS 可以把书中的文字合成为语音。本教程使用 Origo X 内置的「豆包」预设，对应豆包语音合成 2.0。你需要先在火山引擎开通服务、获取自己的 API Key，再把密钥填入 APP。
官方申请入口
- 申请 / 管理豆包语音 API Key：登录火山引擎后进入密钥管理页。
- 官方快速入门：新版控制台：查看注册、实名认证和服务开通流程。
- 官方 API Key 使用说明：查看密钥获取、禁用和删除方式。
请选择豆包语音新版控制台。普通火山方舟聊天模型的 API Key、火山引擎 AccessKey / SecretKey，以及旧版语音控制台的 AppID / Access Token，都不能直接当作本教程的语音 API Key 填入 APP。
第一步：注册并开通语音服务
- 打开上面的官方申请入口，注册或登录火山引擎账号。首次使用时，按页面要求完成实名认证。
- 进入豆包语音新版控制台，确认当前项目。第一次配置可以使用默认的
default项目。 - 在「开通管理」中找到豆包语音合成模型 2.0，按控制台提示开通，并确认服务状态可用。新用户也可以使用官方提供的一键开通入口；完成后再核对语音合成 2.0 的状态。
- 查看该服务的试用额度、有效期和计费说明，再决定是否继续使用。密钥可见不代表语音服务已经开通。
火山引擎可能提供试用额度，具体数量和有效期以你账号的控制台为准。试用额度耗尽后，已开通的服务可能继续按后付费计费，不要把试用理解为永久免费。官方流程和额度说明见新版控制台快速入门。Origo X 的账户权益不包含火山引擎的语音用量费用。
第二步：获取 API Key
- 保持在刚才开通服务的项目下，打开API Key 管理。链接默认进入
default项目；如果你使用其他项目，请先切换到对应项目。 - 获取一个可用的 API Key；需要新建时，使用页面提供的创建入口，按提示填写名称，例如
Origo X 听书。 - 复制完整的密钥，接下来粘贴到 APP 的「API Key」输入框。只复制密钥本身，不要附带引号、
Bearer或X-Api-Key:。
新版语音服务使用一个 API Key 完成鉴权，配置内置豆包预设时不需要另填 AppID。相关说明见官方 API Key 使用文档。
第三步：填入 Origo X
以下名称以 APP 简体中文界面为准。如果你的版本没有「云端 TTS」入口，先到下载与更新检查版本；如 APP 提示登录或开通相应权益，按提示完成后继续。
- 打开 APP 的设置 → 云端 TTS。
- 在「语音服务」中点击豆包，进入配置页。
- 「语音模型」选择豆包语音合成 2.0；「音色」可以先选择预设的 Vivi 2.0。
- 在 API Key 输入框粘贴刚才复制的密钥。
- 点击试听当前音色，确认能听到示例语音。试听会暂停正在播放的听书，也可能产生服务商用量费用。
- 试听成功后点击保存并使用，保存这份配置并选用云端朗读。
使用内置「豆包」预设时，接口地址和模型已经填好，通常只需要选择音色、填入 Key。需要核对时，展开「高级自定义」：
| 配置项 | 本教程使用的值 |
|---|---|
| 语音服务 | 豆包 |
| 语音模型 | 豆包语音合成 2.0 |
| 示例音色 | Vivi 2.0 |
| 音频格式 | mp3 |
| API Key | 你在豆包语音新版控制台获取的完整密钥 |
高级自定义中的「自定义模型 ID」为 seed-tts-2.0，「自定义音色 ID」示例为 zh_female_vv_uranus_bigtts。「服务地址」保留以下完整地址：
https://openspeech.bytedance.com/api/v3/tts/unidirectional
接口地址和资源 ID 对应官方单向流式语音合成 HTTP 文档。首次配置保留预设即可；其他音色需要与模型版本及账号的音色权限相匹配。
第四步：开始听书
打开一本书，进入朗读界面，在听书设置中确认引擎为云端 TTS，并选择刚才保存的豆包配置，再开始播放。建议先听一个短段落，确认音色、语速和网络正常后再连续听书。
你也可以从朗读界面的「配置云端朗读」或「管理音色与连接」进入配置页。播放控制和定时停止见朗读与听书。
常见问题
提示密钥错误、请求失败或合成失败
先检查 Key 是否复制完整、是否已被禁用或删除，再确认它来自豆包语音新版控制台。随后在同一个项目中核对语音合成 2.0 的开通状态、额度或余额，以及当前音色权限。仍失败时，检查设备能否访问官方接口，再重新试听。
听到的仍然是系统语音
确认听书引擎已选为「云端 TTS」，并选中了保存的豆包配置。如果打开了「失败时使用系统语音」，云端请求失败后可能切回系统语音。可以先用配置页的「试听当前音色」排查；试听会直接显示云端错误，便于确认配置是否可用。
想换音色，或只有某个音色失败
先换回预设的 Vivi 2.0 测试，再在控制台核对可用音色及权限。seed-tts-2.0 对应 2.0 音色；不要把其他模型版本的音色 ID 混填进来。首次配置建议使用 APP 的预设音色，其他音色可在「高级自定义」中填写官方音色 ID。
换了手机，或重新打开配置时 Key 为空
已有密钥时，编辑页可能提示已保存，输入框留空会保留原密钥；需要更换时粘贴新的 Key 后保存。换设备后请检查密钥是否存在，缺失时在新设备上重新填写。
API Key 不小心泄露了
在官方 API Key 管理页禁用或删除旧 Key，获取新的 Key，再到 APP 更新并试听。反馈问题时只提供 APP 版本、系统、所选模型、音色和去除密钥后的错误提示；截图不要露出完整 Key。
本文官方入口与说明核对于 2026 年 10 月 11 日。火山引擎可能调整界面名称、服务开通方式和额度，申请时以官方控制台当前提示为准。
发现文档中的问题？ 提出修正