Быстрый старт

Эта страница поможет вам быстро выполнить реальный запрос на преобразование текста в речь. Начните с синхронного TTS, поскольку он возвращает звук напрямую и это самый простой путь для тестирования.

1. Создайте ключ API

Создайте ключ API в своей учетной записи Fish Audio:

Открыть настройки API

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

export FISHAUDIO_API_KEY="YOUR_API_KEY"

2. Выберите голос

Список голосов, доступных для вашей учетной записи:

curl "https://fishaudio.org/api/open/v1/voices" \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY"

Скопируйте возвращенный идентификатор голоса и используйте его как voiceId. Чтобы немедленно проверить соединение, используйте общедоступный системный тестовый голос 00a1b221-6137-4b73-ad62-b0cbce134167, а затем замените его на предпочитаемый вами голос позже.

3. Генерация речи

curl -X POST "https://fishaudio.org/api/open/v1/speech/tts" \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -o speech.audio \
  -d '{
    "text": "Hello from Fish Audio.",
    "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167"
  }'

Если запрос успешен, speech.audio сохраняется в вашем текущем каталоге. Используйте заголовок ответа Content-Type, чтобы выбрать окончательное расширение файла.

Следующие шаги