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

Настройка RimTalk TTS

Добавьте Fish Audio как OpenAI-совместимого провайдера RimTalk TTS и назначьте колонистам RimWorld разные голоса.

Подключение Fish Audio к RimTalk TTS

RimTalk TTS может обращаться к Fish Audio через пользовательского OpenAI-совместимого провайдера и озвучивать реплики колонистов разными голосами.

Проверьте версию RimTalk

В настройках должны присутствовать раздел Custom TTS Providers (Untested!) и кнопка добавления провайдера. Сейчас эта возможность находится в ветке разработки проекта. Если раздела нет, сначала проверьте источник и версию мода.

Что потребуется

Создайте отдельный API-ключ для RimTalk и подготовьте Fish Audio Voice ID. Не публикуйте полный ключ на снимках экрана, в чатах или файлах мода. Уже раскрытый ключ необходимо отозвать.

Для первой проверки доступен системный голос:

00a1b221-6137-4b73-ad62-b0cbce134167

Параметры провайдера

Откройте TTS Configuration → Custom TTS Providers → Add New Custom Provider и заполните:

ПолеЗначение
Provider nameFish Audio
Base URLhttps://fishaudio.org/v1
Endpoint path/audio/speech
Modelfishaudio-s21pro-flash
Default voice00a1b221-6137-4b73-ad62-b0cbce134167
Response formatmp3
Auth header nameAuthorization
Auth header prefixBearer и один пробел после него
Timeout60 секунд

Полный адрес должен выглядеть как https://fishaudio.org/v1/audio/speech. Включите speed, а streaming, temperature, top_p, дополнительные эмоции и шаблон тела запроса оставьте выключенными.

Не используйте tts-1, alloy или значение старого провайдера s2.1-pro. Модель движка и UUID голоса являются разными параметрами.

Назначение голосов

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

Проверка и ошибки

Начните с одной короткой реплики одного колониста. Убедитесь, что сервер отвечает HTTP 200, MP3 воспроизводится полностью, а расход виден в управлении API.

  • 401: проверьте ключ и пробел после Bearer.
  • 402: пополните баланс API-кредитов.
  • 404: Base URL должен заканчиваться на /v1, путь — /audio/speech.
  • 400: проверьте модель и UUID голоса.
  • Тайм-аут: используйте flash-модель, 60 секунд и короткий текст.
  • 429: сохраните задержку между генерациями и уменьшите параллельные запросы.

RimTalk ожидает синхронный аудиоответ и не опрашивает асинхронные задачи, поэтому длинный текст следует сократить.

Ссылки