API транскрибации аудио и видео — REST с разделением голосов

Кому это нужно

• CRM-системы: автоматическая расшифровка записей звонков отдела продаж. Стенограммы прикрепляются к карточке сделки, можно искать по содержанию.
• Аналитика переговоров: анализ NPS, выявление возражений, проверка скриптов. JSON-выход легко скармливается LLM для построения дашбордов.
• Подкаст-платформы: авто-генерация шоу-нот, описаний эпизодов, SRT-субтитров для встроенного плеера.
• EdTech: расшифровка лекций и вебинаров → поиск по конспекту → доступность для слабослышащих студентов.
• Медиа и новостные сайты: расшифровка интервью для оперативной публикации цитат.
• Юридические сервисы: стенограммы с тайм-кодами для процессуальных документов.

Как работает API

Пример: расшифровать файл за 5 строк

Минимальный Python-пример (стандартная requests):

import requests

API_KEY = "dsk_live_..."
headers = {"Authorization": f"Bearer {API_KEY}"}

# Загружаем файл
with open("meeting.mp4", "rb") as f:
    r = requests.post(
        "https://deepscribe.ru/api/v1/jobs",
        headers=headers,
        files={"file": f},
        data={"diarize": "true", "language": "ru"},
    )
job_id = r.json()["job_id"]

# Polling — ждём завершения
import time
while True:
    r = requests.get(f"https://deepscribe.ru/api/v1/jobs/{job_id}", headers=headers)
    if r.json()["status"] == "done":
        break
    time.sleep(5)

# Получаем JSON-транскрипт
r = requests.get(f"https://deepscribe.ru/api/v1/jobs/{job_id}/transcript.json", headers=headers)
transcript = r.json()
for chunk in transcript["chunks"]:
    print(f"[{chunk['start_sec']:.1f}s] {chunk['speaker']}: {chunk['text']}")
        

Полная документация с примерами на Python, Node.js, curl, Go: /api/docs

Webhooks вместо polling

Если не хотите опрашивать статус — передайте webhook_url в POST'е. После завершения обработки мы пришлём результат на ваш endpoint:

POST /your-webhook HTTP/1.1
Content-Type: application/json
X-DeepScribe-Signature: sha256=...

{
  "job_id": 12345,
  "status": "done",
  "duration_sec": 1834.5,
  "n_speakers": 3,
  "transcript_url": "https://deepscribe.ru/api/v1/jobs/12345/transcript.json",
  "docx_url": "https://deepscribe.ru/api/v1/jobs/12345/transcript.docx",
  "srt_url": "https://deepscribe.ru/api/v1/jobs/12345/transcript.srt"
}
        

Подпись проверяется через HMAC-SHA256 с вашим webhook_secret. Гарантия доставки: 3 попытки с backoff (5с / 30с / 5мин).

Особенности API

Часто задаваемые вопросы

Смежные сценарии