OpenAI-Совместимость с TTS

Используйте эту конечную точку, когда клиент ожидает контракт OpenAI POST /v1/audio/speech. Он предназначен для таких интеграций, как поставщик Пользовательского протокола OpenAI TTS компании Tavo.

Для встроенной интеграции Fish Audio с контрактом полного запроса используйте Sync HTTP.

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

POST /v1/audio/speech
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

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

https://fishaudio.org/v1/audio/speech

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

Запрос

{
  "model": "fishaudio-s21pro-flash",
  "input": "Hello from Fish Audio.",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}

Получите голосовые идентификаторы от GET /api/open/v1/voices. Для быстрой проверки соединения используйте общедоступный системный голос 00a1b221-6137-4b73-ad62-b0cbce134167. Используйте поддерживаемый идентификатор модели Fish Audio TTS; Названия моделей OpenAI, такие как tts-1, не являются псевдонимами моделей Fish Audio.

Некоторые сторонние клиенты обнаруживают голоса через список голосов, совместимый с OpenAI. Они могут позвонить:

GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY

Используйте возвращенное значение voices[].id в качестве voice в речевом запросе.

Ответ

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

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

<binary audio data>

Клиент должен сохранить или воспроизвести ответ в соответствии с Content-Type. Ошибки представляют собой ответы JSON и используют ту же аутентификацию, квоту и поведение генерации, что и собственная конечная точка синхронизации.

curl Пример

curl -X POST "https://fishaudio.org/v1/audio/speech" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fishaudio-s21pro-flash",
    "input": "Hello from Fish Audio.",
    "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "response_format": "mp3",
    "speed": 1
  }' \
  --output speech.mp3

Подключите Таво

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

Ошибки