Настройка AstrBot
Подключите AstrBot к Fish Audio через OpenAI TTS Provider и используйте клонированный голос для ответов агента.
Подключение Fish Audio TTS к AstrBot
AstrBot может вызывать Fish Audio через OpenAI-совместимый речевой endpoint. Персоны и TTS Provider настраиваются отдельно: сначала создайте провайдер, затем назначьте его через конфигурацию по умолчанию или пользовательское правило.
Подготовить API Key и Voice ID
Создайте ключ на странице управления API, скопируйте Voice ID клонированного голоса и проверьте API-кредиты. Для первого теста можно использовать:
00a1b221-6137-4b73-ad62-b0cbce134167Добавить TTS Provider
В панели AstrBot добавьте провайдер синтеза речи и выберите OpenAI TTS (API).
| Параметр | Значение |
|---|---|
| API Key | Ваш Fish 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)
Этот провайдер использует другой нативный API и требует 32-символьный шестнадцатеричный reference ID. Для голосов fishaudio.org используйте OpenAI TTS Provider и платформенный Voice ID.
Включить голосовые ответы
Включите TTS в AstrBot и выберите созданный провайдер. Для нескольких агентов создайте провайдер для каждого Voice ID, затем назначьте персону и TTS Provider пользовательскими правилами.
Устранение неполадок
- Недопустимый Voice: укажите Voice ID, а не отображаемое имя.
- 404: используйте
https://fishaudio.org/v1без повторного/audio/speech. - 401/402: проверьте ключ и отдельный баланс API-кредитов.
- Неверный API: выберите OpenAI TTS (API), а не FishAudio TTS (API).
- Тайм-аут: задайте
60секунд и сначала проверьте короткий текст.
Связанная документация
Настройка WorkBuddy (бета-версия)
Установите бета-версию WorkBuddy Skill, которая генерирует речевые файлы MP3 с помощью Fish Audio API.
Настройка домашнего помощника
Используйте пользовательскую конечную точку HACS OpenAI TTS для создания объявлений Fish Audio и ответов голосового помощника в Home Assistant.