Укажите провайдеру Kitta AI в RikkaHub совместимую конечную точку /v1/tts и задайте Voice ID с моделью.

Подключите Kitta AI TTS к RikkaHub

В RikkaHub выберите голосового провайдера Kitta AI и укажите базу API на Kitta AI вместо api.fish.audio. Затем настройте API-ключ, Voice ID и модель для /v1/tts.

После настройки речевые запросы RikkaHub расходуют ваш кредитный баланс Kitta AI API и воспроизводят звук через выбранный голосовой идентификатор.

Что вам нужно

Учетная запись Kitta AI с кредитами API;
Ключ Kitta AI API;
Голосовой идентификатор Kitta AI (reference_id);
RikkaHub с доступным речевым провайдером Kitta AI.

Ключ API — это конфиденциальные учетные данные. Не делитесь им в чате, не делитесь скриншотами или ненадежными веб-сайтами. Создайте специальный ключ для RikkaHub, чтобы вы могли отслеживать или отзывать его отдельно.

Шаг 1. Создайте ключ Kitta AI API.

Войдите в Kitta AI, откройте управление API и создайте ключ для RikkaHub. Скопируйте и немедленно сохраните его, поскольку полный ключ может быть показан только один раз.

Шаг 2. Найдите голосовой идентификатор

RikkaHub отправляет голосовой идентификатор как reference_id. Скопируйте один из голосового списка Kitta AI или запросите API:

GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEY

Чтобы немедленно проверить соединение, начните с голосового идентификатора общедоступной системы:

00a1b221-6137-4b73-ad62-b0cbce134167

Замените его на предпочитаемый голосовой идентификатор после того, как RikkaHub сможет успешно генерировать и воспроизводить звук.

Не путайте модель и голос:

В шапке модели выбирается версия двигателя TTS;
reference_id выбирает голос говорящего.
Список доступных голосов
Создать собственный голос

Шаг 3. Настройте провайдера Kitta AI в RikkaHub.

В RikkaHub откройте настройки провайдера Kitta AI/TTS и введите:

Настройка RikkaHub	Значение
API Базовый/конечный хост	`https://kittaai.com`
Полная конечная точка (если требуется)	`https://kittaai.com/v1/tts`
API Ключ	Ваш ключ Kitta AI API
Модель	`s2.1-pro` или `s2.1-pro-flash`
Голос / `reference_id`	`00a1b221-6137-4b73-ad62-b0cbce134167` (заменить после тестирования)
Формат	`mp3`

Используйте любые имена полей, которые показывает ваша сборка RikkaHub. Важная часть заключается в том, что запрос достигает POST https://kittaai.com/v1/tts с:

Authorization: Bearer YOUR_API_KEY
model: s2.1-pro
Content-Type: application/json

и тело JSON, которое включает text плюс непустой reference_id.

Если RikkaHub предварительно заполняет https://api.fish.audio, замените хост на https://kittaai.com и сохраните /v1/tts.

Сохраните провайдера, сгенерируйте одно короткое предложение и подтвердите, что RikkaHub может воспроизводить возвращенный звук.

Шаг 4. Назначьте голос там, где это необходимо.

Если RikkaHub позволяет выбрать голос для каждого персонажа, чата или помощника, вставьте в это поле тот же голосовой идентификатор Kitta AI. Вы можете повторно использовать одну конфигурацию провайдера и изменять reference_id только для каждого символа.

API использование кредита

RikkaHub вызывает Kitta AI /v1/tts и использует отдельный кредитный баланс API. Преобразование текста в речь начинается с 1 балла API за эффективный символ, а в некоторых моделях может применяться множитель.

Покупайте кредиты в ценах API и просматривайте баланс в управлении API. Успешные ответы могут включать X-OpenAPI-Credits-Used.

Устранение неполадок и часто задаваемые вопросы

RikkaHub сообщает об ошибке соединения

Подтвердите, что хост — https://kittaai.com, удалите пробелы из ключа API и убедитесь, что в учетной записи все еще есть кредиты API. Не вводите пароль своей учетной записи Kitta AI.

Запрос возвращает 400 и упоминает `reference_id`

Kitta AI требует явного голосового идентификатора. Введите действительный reference_id; сервер не будет молча выбирать голос по умолчанию.

Запрос возвращает 401 или говорит, что ключ API недействителен.

Скопируйте ключ Kitta AI API еще раз. Если он был отозван, создайте новый ключ и замените учетные данные, хранящиеся в RikkaHub.

Запрос возвращает 402 или сообщает, что баланса недостаточно.

Ваш кредитный баланс API слишком мал. Членские кредиты и кредиты API представляют собой отдельные балансы, поэтому приобретите кредиты API на странице цен API.

RikkaHub подключается, но не воспроизводит звук

Сначала протестируйте с помощью mp3. Если клиент запросил opus, Kitta AI возвращается к mp3, чтобы обычные игроки Android могли декодировать ответ. Также убедитесь, что голосовой идентификатор действителен и что настройки автовоспроизведения или отключения звука RikkaHub не блокируют воспроизведение.

Какую модель мне выбрать?

Начните с s2.1-pro или s2.1-pro-flash. Kitta AI сопоставляет эти метки fish.audio с соответствующими идентификаторами моделей движка. Собственные идентификаторы, такие как fishaudio-s21pro-flash, также работают в заголовке model.

Руководство по настройке RikkaHub