Синтез речи

POST

/api/tts

Синтезировать речь из текста.

Отправьте текст и идентификатор голоса для генерации аудио.
Запрос блокируется до завершения синтеза и возвращает аудиофайл напрямую.

Поле voice_id принимает как персональные голоса, так и голоса из публичного каталога.
Сначала проверяются персональные голоса.

Пример запроса:

Замените YOUR_VOICE_ID на ID из GET /api/voices/public или готового
персонального голоса. Запрос принимает до 500 исходных символов.

curl --fail https://api.genvoice.ru/v1/api/tts \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Привет, мир!","voice_id":"YOUR_VOICE_ID","output_format":"mp3_24000_48"}' \
  --output speech.mp3

Успешный ответ — 200 OK, тело содержит MP3 (Content-Type: audio/mpeg),
а не JSON или ссылку. При HTTP-ошибке --fail не записывает тело ошибки в файл.

Быстрый старт с выбором голоса и Python-примером ·
Подготовка персонального голоса · Форматы аудио.

Authorizations

HTTPBearer

API-ключ в формате: Bearer sk_live_YOUR_API_KEY

Type

HTTP (bearer)

Example"Bearer sk_live_YOUR_API_KEY"

Request Body

application/json

{

"text": "Привет, добро пожаловать в GenVoice!",

"voice_id": "string",

"model": "GENVOICE",

"output_format": "mp3_24000_48",

"speed": 1,

"normalize": true

}

Responses

Successful Response

POST

/api/tts

Playground

Authorization

HTTPBearer

Body

Samples