Создать задачу на синтез

Обновлено 21 марта 2025

POST

/text:async_synthesize

Возвращает идентификатор созданной задачи на синтез. В запросе нужно передать идентификатор загруженного файла, а также параметры распознавания.

Подробнее — в разделе Асинхронный синтез речи.

Запрос

Header Parameters

X-Request-ID

uuid

Значение должно соответствовать регулярному выражению (([0-9a-fA-F-])36)

Уникальный ID запроса, который используется для поиска запроса в логах. Если ID не задан явно, то сервер сгенерирует его автоматически.

• application/json

Body

Возвращает идентификатор задачи на синтез

request_file_id

uuid

required

Значение должно соответствовать регулярному выражению (([0-9a-fA-F-])36)

Идентификатор загруженного файла.

audio_encoding

string

required

Возможные значения: [Opus, MP3, PCM_S16LE, FLAC, ALAW, MULAW]

Аудиокодек.

Единственное возможное значение — opus.

Подробнее — в разделе Доступные форматы аудио.

voice

string

required

Код голоса для озвучивания.

Возможные значения смотрите в разделе Примеры голосов.

Ответы

• 200
• 400
• 401
• 413
• 500

Идентификатор созданной задачи на синтез.

• application/json

• Схема
• Пример из схемы

Schema

status

integer

required

HTTP-код ответа.

result

object

required

Результат создания задачи

id

string

Идентификатор задачи

created_at

date-time

Дата создания задачи

updated_at

date-time

Дата обновления статуса задачи

status

string

Возможные значения: [NEW, RUNNING, CANCELED, DONE, ERROR]

Статус задачи

{
  "status": 200,
  "result": {
    "id": "5f5c6e6eed15b23b357852d52d3c979f",
    "created_at": "2017-10-10T10:00:00.000+03:00",
    "updated_at": "2021-01-01T00:00:00.000+03:00",
    "status": "NEW"
  }
}

Bad request format

Unauthorized

Payload too large

Internal Server Error

Loading...

Loading...