Fish Audio совместимый TTS

Используйте эту конечную точку, когда клиент жестко запрограммирует форму запроса fish.audio POST /v1/tts. Он отображает эту полезную нагрузку в конвейер Fish Audio Open TTS, сохраняя при этом аутентификацию, квоту и выставление счетов по ключу API в вашей учетной записи Fish Audio.

Для встроенной интеграции Open API выберите Sync HTTP. Для клиентов OpenAI POST /v1/audio/speech используйте OpenAI-совместимый TTS.

Конечная точка

POST /v1/tts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
model: s2.1-pro

Полный URL-адрес:

https://fishaudio.org/v1/tts

Если стороннее приложение запрашивает базу Fish Audio API, например https://api.fish.audio, установите для нее значение https://fishaudio.org и оставьте путь как /v1/tts.

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

Запрос

{
  "text": "Hello from Fish Audio.",
  "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "format": "mp3",
  "temperature": 0.7,
  "top_p": 0.7,
  "normalize": true,
  "prosody": {
    "speed": 1
  }
}

Сопоставление заголовков модели

Неизвестные значения заголовка игнорируются, и применяется механизм сервера по умолчанию. Вы также можете отправить в заголовке собственный идентификатор движка, например fishaudio-s21pro-flash.

Получите голосовые идентификаторы от GET /api/open/v1/voices. Для быстрой проверки соединения используйте общедоступный системный голос 00a1b221-6137-4b73-ad62-b0cbce134167.

Ответ

Успешный запрос возвращает двоичный звук:

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-OpenAPI-Quota-Remaining: 987988
X-OpenAPI-Credits-Used: 12

<binary audio data>

Ошибки — JSON, а аутентификация, квоты и поведение генерации используются совместно с Sync HTTP.

curl Пример

curl -X POST "https://fishaudio.org/v1/tts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "model: s2.1-pro" \
  -d '{
    "text": "Hello from Fish Audio.",
    "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "format": "mp3",
    "prosody": { "speed": 1 }
  }' \
  --output speech.mp3

Подключите RikkaHub

Для настройки ключа API, базового URL-адреса, модели и голоса в RikkaHub следуйте специальному Руководству по настройке RikkaHub.

Ошибки