在 Tavo 中將 Fish Audio 配置為自訂 OpenAI 相容 TTS 提供程序，然後將 Fish Audio 語音指派給您的角色。

將 Fish Audio TTS 連接到 Tavo

本指南介紹如何在 Tavo 中將 Fish Audio 配置為自訂 OpenAI 相容 TTS 提供程序，並將 Fish Audio 語音指派給角色。設定完成後，Tavo 可以用您選擇的聲音朗讀字元訊息。

你需要什麼

1、一個Fish Audio帳戶，擁有API積分；2. Fish Audio API 鑰匙一把；3.您要使用的Fish Audio語音ID；4. 運行中的 Tavo 安裝。

API 金鑰是敏感憑證。請勿將其發送給其他人或將其包含在聊天訊息、公共螢幕截圖或不受信任的網站中。為 Tavo 建立專用金鑰，以便您可以單獨監控或撤銷它。

步驟1：建立Fish Audio API金鑰

登入Fish Audio，開啟API管理，為Tavo建立金鑰。立即複製並儲存它，因為完整的密鑰可能只會顯示一次。

第 2 步：尋找語音 ID

Tavo 需要語音 ID 來合成具有特定聲音的語音。從您的 Fish Audio 語音清單中複製一個或查詢 API：

若要立即測試連接，請從此公共系統語音 ID 開始：

00a1b221-6137-4b73-ad62-b0cbce134167

使用它進行初始連接測試，然後在 Tavo 可以成功生成並播放音訊後將其替換為您首選的語音 ID。

GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEY

不要混淆model和voice欄位：model選擇TTS引擎，而Voice ID選擇揚聲器的聲音。

步驟3：在Tavo中加入語音API

在塔沃，打開：

More → Voice & Image Generation → Voice API → New

選擇 TTS 自訂 OpenAI 協定模型，然後輸入：

塔沃設定	價值
API 基本 URL	`https://fishaudio.org/v1`
API 鑰匙	您的 Fish Audio API 鑰匙
型號 ID	`fishaudio-s21pro-flash`
語音辨識	`00a1b221-6137-4b73-ad62-b0cbce134167`（測試後更換）
音訊格式	`mp3`

基本 URL 應以 /v1 結尾。不要附加/audio/speech； Tavo 在發送請求時新增完整的 /v1/audio/speech 路徑。

保存提供者。如果 Tavo 提供連接測試，請產生一個短句子並確認音訊播放。

步驟 4：將聲音指派給角色

創建好語音API後，開啟Tavo的角色語音綁定介面：

Character Voice Binding → Select Character → Select Your Voice API

如果 Tavo 要求輸入語音 ID，請再次輸入相同的 Fish Audio 語音 ID。保存綁定，返回聊天，發送短信，開始語音播放。

您可以為每個角色指派不同的 Fish Audio 語音。重複使用提供者設定並僅變更每個字元綁定中的語音 ID。

API 積分使用情況

Tavo 透過 Fish Audio /v1/audio/speech 產生語音並消耗單獨的 API 信用餘額。文字轉語音從每個有效字元 1 API 學分開始，某些型號可能會應用乘數。

從API定價購買積分並在API管理中查看餘額。實際請求成本以 X-OpenAPI-Credits-Used 形式回傳。

故障排除與常見問題解答

Tavo 報告連線失敗

確認基本 URL 為 https://fishaudio.org/v1，刪除 API 金鑰中的空格，並驗證該帳戶是否仍具有 API 積分。不要輸入您的 Fish Audio 帳戶密碼。

請求回傳401或說API金鑰無效

再次複製 Fish Audio API 金鑰。如果已撤銷，請建立新金鑰並取代儲存在 Tavo 中的舊憑證。

請求回傳402或說餘額不足

您的 API 信用餘額太低。會員積分和 API 積分是單獨的餘額，因此請從 API 定價頁面購買 API 積分。

Tavo 連接但不播放音頻

驗證角色是否已綁定到語音API，且語音ID是否有效。先用 mp3 測試一個短句子，然後檢查 Tavo 的自動播放、靜音和背景播放設定。

Tavo 說模型或聲音無效

使用 fishaudio-s21pro-flash 作為型號 ID，使用 Fish Audio 語音 ID 作為語音。 OpenAI 名稱（例如 tts-1 和 alloy）不會自動對應到 Fish Audio 模型或語音。

每個角色可以使用不同的聲音嗎？

是的。為每個角色輸入相符的Fish Audio語音ID，以賦予角色不同的聲音。

塔沃設定指南