Текст в речь (HTTP)

Клонирование голоса - создать модель

Липсинк - создать задачу

Профиль пользователя

Текст в речь (HTTP) — HTTP v2

Синтез речи по ID голоса с дополнительными настройками движка.

Текст в речь (HTTP v2)

Синтез речи по ID голоса с дополнительными настройками движка.

Endpoint

POST /api/open/v2/speech/tts

Заголовки запроса

Content-Type
stringheaderОбязательно
application/json
Authorization
stringheaderОбязательно
Bearer <token> (API ключ)

Параметры запроса

application/json
voiceId
stringОбязательно
Клонирование голоса - список моделей
modelId
stringНеобязательноНеобязательно: engine
Клонирование голоса - создать модель
Доступные варианты:fishaudio-s2profishaudio-s1minimax-2.8-turbominimax-2.8-hdminimax-2.6-turbominimax-2.6-hdqwen3-tts-flash
text
stringОбязательно
Речь в текст
format
stringНеобязательноНеобязательно: mp3
Несколько форматов
Доступные варианты:mp3wavogg
speed
numberНеобязательноНеобязательно: 1
Быстрая генерация
volume
numberНеобязательноНеобязательно: 0
Доступные варианты:
stability
numberНеобязательно
Синхронизация аудио и видео
similarity
numberНеобязательно
Клонирование голоса - создать модель
pitch
numberНеобязательно
Доступные варианты:
language
stringНеобязательно
Доступные варианты:
emotion
stringНеобязательно
Безграничное творчество
Доступные варианты:happysadangryfearfuldisgustedsurprisedcalm
token
string // Optional if Authorization: Bearer is set
Остаток API-квоты и базовая информация аккаунта.

Данные ответа

// Данные ответа - 200
Content-Type: audio/mpeg (or audio/wav / audio/ogg depending on format)
<Несколько форматов>

// Данные ответа

// Запрос не выполнен
{
  "code": string,
  "message": string,
  "requestId"?: string
}

Пример CURL

curl -X POST https://fishspeech.vercel.app/api/open/v2/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "modelId": "fishaudio-s2pro",
    "text": "Hello, world.",
    "format": "wav",
    "speed": 1,
    "volume": 0
  }' \
  --output output.wav

Онлайн-отладка

Коды статуса

200: Success
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Internal Server Error