Отправьте файл или ссылку на YouTube, Rutube, VK Видео одним POST-запросом и получите текст с таймкодами, разметкой спикеров и AI-саммари. О готовности сообщит вебхук.
API работает на любом платном тарифе, от Базового. Качество распознавания можно бесплатно попробовать в личном кабинете.
# API_BASE — адрес API из документации в личном кабинетеcurl -X POST "$API_BASE/v1/transcriptions" \ -H "Authorization: Bearer $AUDIO2TEXT_API_KEY" \ -H "Idempotency-Key: meeting-2026-09-29" \ -F "file=@meeting.mp3" \ -F "language=auto" # 202 Accepted{ "id": "123", "status": "queued", "duration_seconds": 1840, "request_id": "req_..."}Нам доверяют команды из крупнейших компаний
Ключ, задача и результат — без SDK и сложной настройки
Личный кабинет → Настройки → API. Выберите scopes — ключ показывается один раз.
Authorization: Bearer tr_live_…POST /v1/transcriptions принимает file или source_url и сразу отвечает 202 с id задачи.
POST /v1/transcriptions
→ 202 {"id":"123","status":"queued"}Дождитесь вебхука transcription.completed или опрашивайте статус, затем запросите результат.
GET /v1/transcriptions/123/result
→ 200 text, segments, …Не просто распознанный текст, а готовая структура: реплики, спикеры, таймкоды, саммари и ваш ID
{ "data": { "id": "123", "status": "done", "language": "ru", "duration_seconds": 1840, "text": "Добрый день! Давайте сверим план на квартал. ...", "segments": [ { "start": 0.0, "end": 4.2, "speaker": "Speaker 1", "text": "Добрый день! Давайте сверим план на квартал." }, { "start": 4.6, "end": 9.8, "speaker": "Speaker 2", "text": "Да, по продажам идём с опережением на 12%." } ], "participants": "...", "summary": "Сверили квартальный план: продажи опережают план на 12%, ...", "tags": "...", "metadata": { "external_id": "crm-call-123" } }, "request_id": "req_..."}Добрый день! Давайте сверим план на квартал.
Да, по продажам идём с опережением на 12%.
Отлично. Тогда обсудим бюджет на рекламу.
AI-саммари в ответе
Сверили квартальный план: продажи опережают план на 12%. Следующий шаг — обсудить рекламный бюджет.
Готовый результат для интеграции, а не только текст распознавания
Аудио или видео в поле file либо source_url на YouTube, Rutube, VK Видео — скачивать ролик самим не нужно.
language=auto определяет язык сам, либо передайте код языка явно.
Каждый сегмент содержит start, end и speaker. Подсказка num_speakers — если число участников известно.
summary, теги и участники приходят в том же /result — без отдельного запроса в LLM.
5 событий, подпись HMAC-SHA256 в Transcripta-Signature, повторная доставка и replay по event id.
Повтор запроса с тем же ключом после сетевой ошибки не создаст вторую задачу.
POST /v1/transcriptions/:id/cancel в статусах queued, downloading, processing, claimed.
Ваш ID сделки, звонка или файла возвращается в статусе, списке и результате задачи.
4 scopes на ключ, 120 запросов в минуту, 20 созданий задач в минуту, баланс в GET /v1/usage.
Сокращённая версия документации: методы, вебхуки, ошибки и лимиты. Полная документация с примерами — в личном кабинете.
Endpoint — только HTTPS. Секрет whsec_ выдаётся один раз при создании. Неудачные доставки повторяются с тем же event id, событие можно отправить повторно через replay.
Transcripta-Event-Id: evt_...Transcripta-Event-Type: transcription.completedTranscripta-Signature: t=1790640000,v1=<hex HMAC-SHA256> { "id": "evt_...", "type": "transcription.completed", "created_at": "2026-09-29T10:00:00.000Z", "data": { "transcription_id": 123, "status": "done", "filename": "meeting.mp3", "duration_seconds": 1840, "error_reason": null }}Подпись: v1 = HMAC-SHA256(whsec_…, «t.сырое тело запроса»). Заголовки Transcripta-* одинаковые на всех доменах сервиса.
Ошибка всегда приходит в одном формате с request_id — его удобно передать в поддержку.
{ "error": { "code": "insufficient_minutes", "message": "...", "request_id": "req_..." }}На ответах /v1/* с ключом приходят заголовки RateLimit-Policy, RateLimit-Limit, RateLimit-Remaining и RateLimit-Reset; при превышении — 429 и Retry-After.
Готовые сценарии с примерами запросов
CRM и телефония
Записи из amoCRM, Битрикс24 или АТС уходят на расшифровку, текст возвращается в карточку сделки.
n8n и скрипты
HTTP Request и Webhook в n8n, скрипт на Python или Telegram-бот для голосовых.
Лекции и вебинары
Ссылка на запись вебинара — и текст с таймкодами для конспекта или базы знаний.
Подкасты и медиа
Расшифровка выпусков для описаний, статей и поиска по архиву.
API входит во все платные тарифы, минуты общие с кабинетом · от 0,50 ₽ за минуту на тарифе «Экспертный» при помесячной оплате
для регулярных задач
сверх лимита — 2 ₽/мин
для большинства задач
сверх лимита — 1 ₽/мин
для больших объёмов
сверх лимита — 1 ₽/мин
Что остаётся сделать вашей команде в каждом варианте
API транскрибации Audio2Text — это REST-интерфейс к тому же распознаванию речи, что работает в личном кабинете. Задача ставится запросом POST /v1/transcriptions: в поле file передаётся аудио- или видеофайл, а в source_url — ссылка на YouTube, Rutube или VK Видео. Ответ приходит сразу — код 202 и id задачи, а готовый результат вы забираете запросом GET /v1/transcriptions/:id/result: полный текст, сегменты с таймкодами start и end, метка спикера в каждом сегменте, AI-саммари, теги, участники и ваши metadata. Язык определяется автоматически, поддерживается 99 языков.
Ключ создаётся в личном кабинете в разделе Настройки → API. У ключа есть scopes: transcriptions:write, transcriptions:read, usage:read и webhooks:write — интеграции можно выдать ровно те права, которые ей нужны. Ключ передаётся в заголовке Authorization: Bearer и показывается один раз, поэтому храните его на сервере, а не в браузере. Чтобы не опрашивать статус, зарегистрируйте HTTPS-вебхук: сервис пришлёт событие transcription.completed с подписью Transcripta-Signature. Повтор запроса с тем же Idempotency-Key не создаст вторую задачу, а отменённая задача вернёт минуты на баланс.
Отдельной платы за API нет: он входит во все платные тарифы, начиная с Базового, и расходует те же минуты, что и работа в кабинете. Сначала списываются минуты тарифа, затем дополнительные. На тарифе Экспертный минута стоит около 0,50 ₽ при помесячной оплате. Остаток минут и статистику запросов возвращает GET /v1/usage. Бесплатных минут для API нет — качество распознавания можно проверить в личном кабинете, а затем подключить тариф.
Коротко о подключении, лимитах и оплате API
Создайте ключ в личном кабинете и отправьте первый запрос — пример выше можно скопировать как есть.
На любом платном тарифе · минуты общие с кабинетом · от 0,50 ₽ за минуту