豆包雲端 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。只複製金鑰本身，不附帶引號、
Bearer或X-Api-Key:。
新版語音服務使用一個 API Key 驗證，內建豆包預設不需要另填 AppID，詳見官方金鑰說明。
第三步：填入 Origo X
以下按鈕名稱以 APP 簡體中文介面為準。若你的版本沒有「云端 TTS」，先到下載與更新檢查版本；如 APP 提示登入或開通相應權益，完成後再繼續。
- 開啟 APP 的设置 → 云端 TTS。
- 在「语音服务」點選豆包。
- 「语音模型」選擇豆包语音合成 2.0；「音色」先選 Vivi 2.0。
- 在 API 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。其他官方音色 ID 可在「高级自定义」填入。
換了裝置，或編輯頁 Key 為空
已有金鑰時，編輯頁可能顯示已儲存，留空會保留原金鑰；更換時貼入新 Key 再儲存。換裝置後請檢查金鑰是否存在，缺少時重新填寫。
金鑰外洩
到官方金鑰管理頁停用或刪除舊 Key，取得新 Key 後在 APP 更新並試聽。回報問題時只提供 APP 版本、系統、模型、音色及移除金鑰的錯誤提示；截圖不要顯示完整 Key。
官方入口與說明核對於 2026 年 10 月 11 日。控制台介面、開通方式和額度可能調整，申請時以官方目前提示為準。
發現文件中的問題？ 提出修正