— API · v1 · stable

Один эндпоинт — и текст у вас.

REST для файлов и URL, WebSocket для потоковой расшифровки, MCP — чтобы агент использовал aiasr как инструмент. Ответы — JSON. Всё.

Базовый URL

https://api.aiasr.ru/v1

Все запросы — по HTTPS. Ответы — JSON, в теле. Ошибки — по стандарту RFC 7807, с полем error.code.

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

API использует bearer-токены. Создайте ключ в Личном кабинете → MCP-токены. Ключ начинается с aiasr_live_.

HEADERAuthorization: Bearer aiasr_live_···

Токен привязан к организации и тарифу. Отозванный ключ перестаёт работать сразу, без ожидания.

Ошибки

код	http	значение
unauthorized	401	Нет/неверный bearer.
quota_exceeded	402	Кончились минуты тарифа.
file_too_large	413	Больше 4 ГБ / 8 часов.
unsupported_media	415	Формат не распознан.
rate_limited	429	Слишком много запросов.
internal	500	Упало у нас; ретрай — безопасно.

Лимиты

10 одновременных заданий на организацию (Команда — 40)
60 запросов/мин на ключ
Файл — до 4 ГБ и 8 часов
Хранение результата — 30 дней, потом удаляется автоматически

POST /transcribe

Создаёт задание на расшифровку. Принимает файл (multipart/form-data) или JSON с URL. Возвращает id задания; результат — через poll или webhook.

POST/v1/transcribe

Параметры тела

имя	тип		описание
file	binary	обяз.	Аудио или видео. mp3, wav, m4a, mp4, mov. До 4 ГБ / 8 часов.
url	string	альт.	Прямой URL файла вместо аплоада. HTTPS.
language	string	опц.	ISO-код. `ru` по умолчанию. Автоопределение — `auto`.
diarize	boolean	опц.	Разделять спикеров. `true` по умолчанию.
vocabulary	string[]	опц.	Словарь терминов: имена, топонимы, жаргон.
webhook_url	string	опц.	Куда прислать POST с результатом.
format	string	опц.	`json` \| `srt` \| `vtt` \| `txt`.

GET /transcribe/:id

Возвращает статус и — когда готово — результат.

GET/v1/transcribe/{id}

Статусы: queued → processing → done | failed.

WebSocket /stream

Потоковая расшифровка. Открываете сокет, шлёте PCM 16 кГц, читаете частичные гипотезы и финальные сегменты.

WSS/v1/stream?language=ru&diarize=true

Задержка — 280–450 мс от акустики до текста. Гипотезы приходят каждые ~100 мс; финал — на границе фразы.

POST /summary

Сводка расшифровки: тезисы, решения, действия. Работает по transcript_id.

POST/v1/summary

Webhooks

Укажите webhook_url в запросе — мы пришлём POST с JSON. Ретраи: 1/5/30 мин, 2/6/24 ч. Подпись — заголовок X-Aiasr-Signature HMAC SHA-256 от тела.

Сервер MCP

aiasr поставляется как MCP-сервер (stdio и SSE). Подключите его к Claude Desktop, Cursor, Windsurf — агент получит инструменты расшифровки и будет звать их сам.

Инструменты агента

transcribe_file — путь или URL → JSON с текстом
transcribe_stream — расшифровка потока в реальном времени
summarize_transcript — тезисы и решения
find_quote — поиск цитаты по смыслу, с таймкодом

SDK — Node.js

Установка: npm i @aiasr/sdk Совместимо с Node 18+.

SDK — Python

Установка: pip install aiasr Python 3.10+.

запрос · curl · node · python

# Transcribe a local file
curl https://api.aiasr.ru/v1/transcribe \
  -H "Authorization: Bearer aiasr_live_···" \
  -F "file=@meeting.mp3" \
  -F "language=ru" \
  -F "diarize=true"

ответ · 200 ok

{
  "id": "trx_01H9W8V2K3",
  "status": "done",
  "language": "ru",
  "duration": 2538,
  "speakers": 4,
  "text": "Давайте по порядку...",
  "segments": [
    {
      "start": 108.4,
      "end": 113.8,
      "speaker": 1,
      "text": "Что у нас с релизом на четверг?"
    }
  ]
}

webhook · POST на ваш url

POST /hook  · X-Aiasr-Signature: sha256=···

{
  "type": "transcript.done",
  "id": "trx_01H9W8V2K3",
  "result_url": "https://api.aiasr.ru/v1/transcribe/trx_01H9W8V2K3"
}