集成指南第三方软件接入
AstrBot 接入教程
在 AstrBot 中通过 OpenAI TTS Provider 接入 Kitta Audio，并让智能体使用你的克隆音色回复。
AstrBot 接入 Kitta Audio TTS
AstrBot 可以通过 OpenAI 兼容语音接口调用 Kitta Audio。配置后，智能体的文本回复会使用你指定的克隆音色生成语音。
AstrBot 将人格或智能体与 TTS 服务商分开管理。因此，先创建 TTS Provider，再在默认配置或自定义规则中把它分配给对应的会话和智能体。
准备 API Key 和音色 ID
第一次测试也可以使用系统测试音色：
00a1b221-6137-4b73-ad62-b0cbce134167添加 TTS Provider
进入 AstrBot 管理面板的服务提供商页面，新增文字转语音服务商，并选择 OpenAI TTS (API)。
填写以下配置：
| AstrBot 配置项 | 值 |
|---|---|
| API Key | 你的 Kitta Audio API Key |
| API Base URL | https://fishaudio.org/v1 |
| Model | fishaudio-s21pro-flash |
| Voice | 你的克隆音色 Voice ID |
| Timeout | 建议 60 秒 |
Base URL 只填写到 /v1。AstrBot 会自动请求完整的 /v1/audio/speech 端点。
不要选择 FishAudio TTS (API)
AstrBot 内置的 FishAudio TTS Provider 面向另一套原生接口，并要求 32 位十六进制 reference ID。fishaudio.org 的克隆音色应通过 OpenAI TTS Provider 使用平台 Voice ID。
启用智能体语音回复
保存 Provider 后，进入 AstrBot 配置：
- 启用文字转语音（TTS）。
- 把 TTS Provider 设为刚创建的 Kitta Audio OpenAI TTS 配置。
- 如需同时发送文字和语音，启用双输出。
- 保存配置并向机器人发送一句短文本。
若多个智能体需要不同音色，可为每个 Voice ID 创建一个 TTS Provider，再使用 AstrBot 的自定义规则为不同会话来源同时指定人格和 TTS Provider。
常见问题
- 音色无效：Voice 必须填写 fishaudio.org 音色页面或音色列表接口返回的 Voice ID，不要填写音色名称。
- 404：API Base URL 应为
https://fishaudio.org/v1，不要追加或重复/audio/speech。 - 401：API Key 无效、已撤销或复制不完整，请创建独立 Key 后重试。
- 402：API 积分余额不足，需要补充 API 积分。
- 请求发往错误的 Kitta Audio 接口：确认服务商类型选择的是 OpenAI TTS (API)，不是 FishAudio TTS (API)。
- 生成超时：把 Timeout 调整为
60秒，并先用短文本测试。 - 只有文字没有语音：确认 AstrBot 已启用 TTS，并且当前会话的自定义规则没有覆盖默认 TTS Provider。