集成指南第三方软件接入
ChatticaAI 接入教程
使用 ChatticaAI 的 Fish Audio 或 OpenAI-compatible TTS 选项配置 API Key、模型和角色音色。
ChatticaAI 接入 Fish Audio TTS
ChatticaAI 是支持角色对话和自定义语音的移动端应用。当前版本提供 Fish Audio TTS 和 OpenAI-compatible TTS 选项，适合为不同角色绑定 Fish Audio 音色。
选择 TTS 类型
打开 ChatticaAI 的语音或 TTS Provider 设置。如果当前版本显示 Fish Audio，优先选择该选项并填写 API Key 与音色 ID；如果需要自定义服务器地址，选择 OpenAI-compatible TTS。
OpenAI-compatible 模式填写：
| 配置项 | 值 |
|---|---|
| Base URL | https://fishaudio.org/v1 |
| API Key | Fish Audio API Key |
| Model | fishaudio-s21pro-flash |
| Voice | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| Format | mp3 |
不同版本的设置名称可能显示为 Provider URL、Endpoint、Voice ID 或 Speaker。Base URL 模式只填写到 /v1；如果应用明确要求完整 Endpoint，则填写 https://fishaudio.org/v1/audio/speech。
绑定角色并测试
保存 Provider 后，在角色的 Voice 或 TTS 设置中选择刚创建的配置。用一句短文本测试播放，确认成功后，再把系统测试音色替换为自己的 Fish Audio 音色 ID。
为不同角色使用不同音色时，可以复用同一套 Base URL、API Key 和模型，只替换角色的 Voice ID。
常见问题
- 没有 OpenAI-compatible 选项：将 ChatticaAI 更新到包含自定义 TTS 支持的版本。
- 404：确认当前字段需要 Base URL 还是完整 Endpoint，不要重复添加
/v1/audio/speech。 - 角色仍使用默认声音：检查角色级 Voice 设置是否覆盖了全局 TTS 设置。
- 401/402：检查 API Key 和 API 积分余额。