API Reference

Базовый адрес: https://{host}/v2. Все ответы — JSON в кодировке UTF-8.

Аутентификация

Каждый запрос должен содержать заголовок Authorization: Bearer <API_KEY>. Ключи выдаются администратором вашей организации в консоли. Публичная регистрация закрыта.

Распознавание файла

POST /v2/recognize — принимает аудио до 100 МБ (OGG/Opus, WAV, MP3, FLAC).

Параметр	Тип	Описание
audio	file	Аудиофайл
language	string	Код языка или auto
punctuation	bool	Расстановка пунктуации, по умолчанию true
diarization	bool	Разделение спикеров

Потоковый режим

Откройте соединение wss://{host}/v2/stream?language=ru с тем же заголовком авторизации и передавайте аудио кадрами PCM 16 кГц по 20–100 мс. Сервер присылает события:

{"type": "partial", "text": "добрый де"}
{"type": "final",   "text": "Добрый день.", "start": 0.12, "end": 0.86}

Языки

GET /v2/languages возвращает список поддерживаемых языков и моделей.

Ошибки

Код	Значение
401	Ключ не передан или недействителен
403	Ключ не имеет доступа к модели
413	Файл слишком большой
429	Превышен лимит запросов

Лимиты

Лимиты и тарифы задаются для организации и отображаются в консоли. По умолчанию — 10 одновременных потоков и 60 запросов в минуту на ключ.

Статус

Все системы работают в штатном режиме.