Настройте агент Hermes для создания речевых файлов через Fish Audio OpenAI-совместимую конечную точку TTS.

Подключите Fish Audio TTS к агенту Hermes

Агент Hermes может использовать собственный базовый URL-адрес для своего встроенного провайдера OpenAI TTS. Это соединяет инструмент text_to_speech с Fish Audio без изменения языковой модели, лежащей в основе Hermes.

Не добавляйте эту конечную точку в список поставщиков моделей Hermes. Fish Audio предоставляет генерацию речи в /v1/audio/speech, а не в конечной точке /v1/chat/completions, необходимой для модели чата.

Прежде чем начать

Вам нужно:

Ключ Fish Audio API с кредитами API.
Голосовой идентификатор Fish Audio
Недавняя установка агента Hermes.

Создайте специальный ключ API для Hermes, чтобы вы могли отслеживать или отзывать его независимо.

Добавляем ключ API

Добавьте ключ в ~/.hermes/.env:

VOICE_TOOLS_OPENAI_KEY=YOUR_FISH_AUDIO_API_KEY

Не помещайте ключ в config.yaml, историю оболочки, скриншоты или репозиторий.

Настроить Fish Audio TTS

Добавьте или обновите раздел tts в ~/.hermes/config.yaml:

tts:
  provider: openai
  speed: 1.0
  openai:
    base_url: 'https://fishaudio.org/v1'
    model: fishaudio-s21pro-flash
    voice: 00a1b221-6137-4b73-ad62-b0cbce134167
    speed: 1.0

Пример голосового идентификатора — это общедоступный системный голос для тестирования соединения. Замените его на предпочитаемый вами Fish Audio Voice ID после первого успешного запроса.

Включите и протестируйте инструмент

Запустите hermes tools и убедитесь, что Voice & TTS включены. Запустите Гермес и спросите:

Use the text_to_speech tool to create an MP3 file that says:
"Hello, this is a Fish Audio test."

Hermes должен сохранить файл MP3 в папке вывода звука и вернуть путь к медиафайлу.

Ограничение канала обмена сообщениями

Эта настройка проверена для создания файлов MP3. Hermes может запросить собственный вывод Opus при доставке голосовых сообщений Telegram или Discord. Конечная точка, совместимая с Fish Audio и OpenAI, в настоящее время поддерживает mp3, wav и pcm, поэтому встроенная доставка голосовых сообщений Opus не поддерживается этой конфигурацией. Используйте вложение MP3 или слой преобразования для этих каналов.

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

Hermes сообщает, что аудиоклавиша OpenAI не настроена: подтвердите, что VOICE_TOOLS_OPENAI_KEY доступен для процесса, запускающего Hermes, затем перезапустите его.
Запросы по-прежнему достигают OpenAI: подтвердите, что tts.provider — это openai, а tts.openai.base_url — это именно https://fishaudio.org/v1.
Неверный голос или модель: используйте идентификаторы Fish Audio, а не голосовые имена OpenAI, такие как alloy, или названия моделей, такие как tts-1.
401: заменить отсутствующий, недействительный или отозванный ключ API.
402: добавьте кредиты API перед повторной попыткой.
Ошибка запроса Opus: запросите файл MP3 вместо встроенного голосового сообщения.

Настройка агента Гермес