Kitta Audio Docs
Руководства по интеграцииСторонние интеграции
Back to site

Настройка AstrBot

Подключите AstrBot к Kitta Audio через OpenAI TTS Provider и используйте клонированный голос для ответов агента.

Подключение Kitta Audio TTS к AstrBot

AstrBot может вызывать Kitta 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Ваш Kitta Audio API Key
API Base URLhttps://fishaudio.org/v1
Modelfishaudio-s21pro-flash
VoiceVoice 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 секунд и сначала проверьте короткий текст.

Связанная документация