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

Руководство по настройке Android Custom TTS

Подключите пользовательский сервис TTS для Android к Kitta AI и используйте клонированный голос в приложениях, поддерживающих движок системы Android TTS.

Используйте Kitta AI в качестве движка TTS системы Android.

Пользовательская служба TTS для Android подключает OpenAI-совместимую конечную точку речи к системному интерфейсу преобразования текста в речь Android. Приложения, использующие выбранный движок Android TTS, смогут читать текст голосом Kitta AI.

System TTS boundary

Это работает только в приложениях Android, использующих движок операционной системы TTS. Приложение со своим встроенный поставщик речи может игнорировать выбор системы Android.

Подготовьте ключ API и Voice ID.

  1. Создайте специальный ключ в управлении API.
  2. Скопируйте голосовой идентификатор своего клонированного голоса.
  3. Убедитесь, что ваш кредитный баланс API достаточен.

Используйте этот системный голос для первого теста:

00a1b221-6137-4b73-ad62-b0cbce134167

Установка и настройка движка

Установите APK со страницы выпуска проекта, откройте приложение и введите:

НастройкаЗначение
Внутренний URL-адресhttps://kittaai.com/v1/audio/speech
API КлючВаш ключ Kitta AI API
Модель TTSfishaudio-s21pro-flash
TTS Голос00a1b221-6137-4b73-ad62-b0cbce134167
Формат ответаwav

Use the complete endpoint and WAV

Служба Android отправляет сообщения непосредственно на внутренний URL-адрес, поэтому включите /audio/speech. Его текущий выпуск поддерживает воспроизведение WAV и PCM, но еще не декодирует MP3 или Opus; используйте wav для Kitta AI.

Нажмите Сохранить, затем нажмите Открыть настройки Android TTS и выберите Пользовательский TTS в качестве предпочтительного механизма. Используйте образец воспроизведения Android или кнопку чтения вслух приложения, чтобы проверить короткое предложение.

Безопасность и голосовые заметки

  • Ключ API хранится на устройстве Android. Используйте специальный ключ, который можно отозвать, не затрагивая другие интеграции.
  • Для поля «Голос» требуется идентификатор голоса Kitta AI, а не отображаемое имя голоса.
  • Заменяйте системный тестовый голос своим клонированным голосом только после успешного первого теста.
  • Доступ к сети требуется всякий раз, когда Android запрашивает движок синтезировать речь.

Поиск неисправностей

  • Нет звука: установите формат ответа на wav; MP3 и Opus указаны, но не декодируются текущим приложением.
  • 404: внутренний URL-адрес должен быть полным адресом https://kittaai.com/v1/audio/speech.
  • 401: заменить сохраненный ключ API действительным выделенным ключом.
  • 402: добавьте кредиты API перед повторной попыткой.
  • 400 или неверный голос: используйте fishaudio-s21pro-flash и действительный голосовой идентификатор Kitta AI.
  • Играет другой голос: выберите «Пользовательский TTS» в настройках системы Android TTS и проверьте, использует ли целевое приложение систему TTS.

Сопутствующая документация