Документация API

REST-интерфейс Дослов: отправьте аудио — получите текст, таймкоды и субтитры. Базовый адрес:

BASEhttps://rezzkost.neurixai.app/api/v1

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

Все запросы идут по HTTPS с ключом в заголовке Authorization. Ключи — в кабинете: pk_live_… для продакшена и pk_test_… для песочницы.

HEADERAuthorization: Bearer pk_live_…

Без корректного ключа ответ — 401:

401

{ "detail": "Not authenticated" }

Создать задачу

POST/jobs

Передайте ссылку на файл в audio_url либо загрузите тело как multipart/form-data. Ответ приходит сразу со статусом queued.

Поле	Тип	Описание
`audio_url`	string	Ссылка на запись. Либо файл в теле запроса.
`language`	string	Код языка (`ru`, `en`…) или `auto`.
`diarize`	bool	Разделять по говорящим. По умолчанию `true`.
`speakers`	int	Необязательно: точное число говорящих.
`formats`	array	Любые из `txt`, `srt`, `vtt`, `docx`, `json`.
`webhook_url`	string	Куда прислать результат по готовности.

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

GET/jobs/{id}

Поле status проходит стадии queued → processing → done (или failed). У готовой задачи в outputs — ссылки на запрошенные форматы, живут 24 часа.

200

{
  "id": "job_8a17f2c0",
  "status": "done",
  "duration_sec": 1340,
  "speakers": 2,
  "outputs": {
    "txt": "https://rezzkost.neurixai.app/f/…/text.txt",
    "srt": "https://rezzkost.neurixai.app/f/…/subs.srt"
  }
}

Форматы и языки

На выходе: txt (чистый текст), srt и vtt (субтитры), docx (для вычитки) и json с таймкодами каждого слова и меткой говорящего. Полный список языков — GET /formats.

Для субтитров задайте max_line_len (символов в строке) и max_lines — нарежем реплики под ваш плеер.

Вебхуки

Когда задача готова, мы шлём POST на ваш webhook_url с телом задачи. Заголовок X-Doslov-Signature — HMAC-SHA256 от тела на секрете вебхука. Сверьте его, прежде чем доверять данным.

POST{webhook_url}

Заголовок	Значение
`X-Doslov-Signature`	HMAC-SHA256 тела запроса
`X-Doslov-Event`	`job.done` или `job.failed`

Ошибки

Код	Значение
`400`	Некорректное тело или неподдерживаемый формат файла
`401`	Нет или недействителен ключ
`404`	Задача не найдена
`413`	Файл превышает лимит длительности тарифа
`429`	Слишком часто — см. заголовок `Retry-After`

Лимиты

Параметр	Значение
Длительность одного файла	до 4 часов
Размер загрузки	до 2 ГБ
Запросов в минуту	120 (`Поток` — выше по договору)
Параллельных задач	5 (`Поток` — выделенная очередь)
Хранение результатов	24 часа на ссылки, текст — по сроку тарифа

Нужен пример под ваш стек? Напишите в поддержку из кабинета — пришлём фрагмент на Python, Node или Go.