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

Подключите Fish Audio TTS к RikkaHub

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

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

Что вам нужно

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

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

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

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

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

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

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

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

00a1b221-6137-4b73-ad62-b0cbce134167

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

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

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

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

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

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

Используйте любые имена полей, которые показывает ваша сборка RikkaHub. Важная часть заключается в том, что запрос достигает POST https://fishaudio.org/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://fishaudio.org и сохраните /v1/tts.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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