完整配置 Tavo 自定义语音 API，填写 Fish Audio API Key、Base URL、模型和音色 ID，并为角色绑定专属 AI 音色。

在 Tavo 中接入 Fish Audio TTS

本教程介绍如何在 Tavo 中将 Fish Audio 配置为自定义 OpenAI 兼容 TTS 服务，并把 Fish Audio 音色绑定到指定角色。完成后，Tavo 可以使用所选音色朗读角色消息。

开始前需要准备

可用的 Fish Audio 账号和 API 积分；
一个 Fish Audio API Key；
一个需要在 Tavo 中使用的 Fish Audio 音色 ID；
已安装并可正常使用的 Tavo。

API Key 属于敏感凭证。不要发送给他人，也不要粘贴到聊天消息、公开截图或不受信任的网站中。建议为 Tavo 单独创建一个 Key，以便查看使用情况或单独撤销。

第一步：创建 Fish Audio API Key

第二步：获取音色 ID

Tavo 需要 Voice ID 才能调用指定音色。你可以从 Fish Audio 音色列表中复制音色 ID，也可以通过 API 查询：

如果只是快速测试接口是否联通，可以先使用下面的系统默认音色 ID：

00a1b221-6137-4b73-ad62-b0cbce134167

该音色可直接用于测试。确认 Tavo 能正常生成和播放语音后，再替换为你准备正式使用的音色 ID。

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

不要把模型 ID 和音色 ID 混用：模型决定使用哪个 TTS 引擎，音色 ID 决定最终声音。

第三步：在 Tavo 新建语音 API

在 Tavo 中打开：

更多 → 语音与生图 → 语音 API → 新建

选择 TTS 自定义 OpenAI 协议模型，然后填写以下内容：

Tavo 配置项	填写内容
API Base URL	`https://fishaudio.org/v1`
API Key	刚创建的 Fish Audio API Key
模型 ID	`fishaudio-s21pro-flash`
Voice ID	`00a1b221-6137-4b73-ad62-b0cbce134167`（测试后可替换）
音频格式	`mp3`

Base URL 应填写到 /v1，不要重复添加 /audio/speech。Tavo 会自动请求完整的 /v1/audio/speech 地址。

填写完成后保存。如果 Tavo 提供连接测试，请先生成一句短文本，确认能够正常播放音频。

第四步：为角色绑定音色

创建语音 API 后，进入 Tavo 的角色语音绑定页面：

角色语音绑定 → 选择角色 → 选择刚创建的语音 API

如果页面要求手动填写 Voice ID，请再次填写同一个 Fish Audio 音色 ID。保存后返回聊天页面，发送一条短消息并触发语音播放。

不同角色可以绑定不同的 Fish Audio 音色，但建议共用同一个 Tavo 语音 API 配置，只在角色绑定中更换 Voice ID。

API 积分消耗

Tavo 通过 Fish Audio /v1/audio/speech 接口生成语音，消耗独立的 API 积分。文字转语音按有效字符数计费，每个字符最低消耗 1 API 积分，部分模型可能应用倍率。

你可以在 API 价格页面购买积分，并在账号 API 页面查看余额。实际消耗以接口响应中的 X-OpenAPI-Credits-Used 为准。

常见问题

Tavo 保存时提示连接失败

确认 Base URL 是 https://fishaudio.org/v1，API Key 没有多余空格，并且账号仍有 API 积分。不要填写 Fish Audio 网页登录密码。

返回 401 或提示 API Key 无效

重新复制 Fish Audio API Key。如果 Key 已被撤销，请创建新 Key，并替换 Tavo 中保存的旧凭证。

返回 402 或提示额度不足

账号的 API 积分余额不足。会员积分和 API 积分是两个独立余额，需要在 API 价格页面单独购买 API 积分。

Tavo 可以连接，但没有声音

检查角色是否已经绑定语音 API，并确认音色 ID 有效。建议先使用短句和 mp3 格式测试，再检查 Tavo 的自动播放、静音和后台播放设置。

模型或音色无效

模型 ID 使用 fishaudio-s21pro-flash，Voice ID 使用 Fish Audio 音色 ID。OpenAI 的 tts-1、alloy 等名称不会自动映射为 Fish Audio 模型或音色。

可以给不同角色使用不同音色吗？

可以。为每个角色填写对应的 Fish Audio 音色 ID，即可让不同角色使用不同声音。

Tavo 接入教程