Руководство по установке OpenMAIC
Добавьте Fish Audio в качестве пользовательского OpenAI-совместимого поставщика TTS в OpenMAIC для учителей искусственного интеллекта, одноклассников и дикторского повествования курса.
Подключаем Fish Audio TTS к OpenMAIC
OpenMAIC поддерживает специальные OpenAI-совместимые поставщики TTS. После подключения Fish Audio учителя искусственного интеллекта, одноклассники, дикторство курса и созданный контент смогут использовать выбранный вами голос.
Подготовьте ключ API и голосовой идентификатор.
- Создайте специальный ключ в управлении API.
- Откройте свой клонированный голос и скопируйте его голосовой идентификатор.
- Убедитесь, что ваш кредитный баланс API достаточен.
Для быстрого теста используйте:
00a1b221-6137-4b73-ad62-b0cbce134167Добавьте собственного поставщика в настройках
Откройте Settings → TTS и добавьте собственный OpenAI-совместимый поставщик TTS. Входить:
| Настройка OpenMAIC | Значение |
|---|---|
| Имя провайдера | Fish Audio |
| Базовый URL | https://fishaudio.org/v1 |
| API Ключ | Ваш ключ Fish Audio API |
| Модель | fishaudio-s21pro-flash |
| Голосовой идентификатор | Голосовой идентификатор вашего клонированного голоса |
| Голосовое имя | Любое отображаемое имя |
OpenMAIC добавляет /audio/speech к базовому URL-адресу и отправляет окончательный запрос на POST /v1/audio/speech. Не указывайте полную конечную точку в поле «Базовый URL».
После добавления голоса сделайте его активным поставщиком TTS и выберите новый идентификатор голоса. Используйте тестовую кнопку TTS с коротким предложением, чтобы проверить голос и аутентификацию.
Prefer server-side keys for shared deployments
OpenMAIC может хранить собственные поставщики в настройках клиента. Введите туда ключ API только на доверенном самостоятельный экземпляр. Для общедоступных или многопользовательских развертываний администраторы должны настроить TTS. на стороне сервера, чтобы ключ не был доступен пользователям браузера.
Конфигурация на стороне сервера
Самостоятельные администраторы могут настроить Fish Audio с переменными среды OpenMAIC:
TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://fishaudio.org/v1Перезапустите OpenMAIC после изменения среды. Затем выберите поставщика OpenAI в настройках TTS и замените модель и голос на идентификатор модели Fish Audio и идентификатор голоса.
Поиск неисправностей
- 404: базовый URL-адрес должен заканчиваться на
/v1. Не вводите/v1/audio/speech, это может дублировать путь. - 401: проверьте ключ API активного провайдера. Перезапустите OpenMAIC после изменения ключа на стороне сервера.
- 402: добавьте кредиты API перед повторной попыткой.
- 400: используйте
fishaudio-s21pro-flashв качестве модели и действительный голосовой идентификатор. - Тест работает, но в классе тихо: сделайте Fish Audio активным провайдером и назначьте его голос роли повествователя.
- CORS браузера или ключевые проблемы: используйте серверную конфигурацию OpenMAIC TTS в общем развертывании.
Сопутствующая документация
Руководство по настройке Anx Reader
Настройте Fish Audio как OpenAI-совместимый сервис TTS в Anx Reader и озвучивайте электронные книги клонированным голосом.
Руководство по настройке LibreChat
Настройте Fish Audio как OpenAI-совместимый серверный поставщик TTS в librechat.yaml и воспроизводите ответы клонированным голосом.