REST API расшифровки аудио и видео для разработчиков

Кому нужен API DeepScribe

REST API DeepScribe — для разработчиков, которым нужно встроить расшифровку аудио в свой продукт. Не платить операторам, не подключать Google Speech-to-Text (передача данных за границу), не разворачивать WhisperX самим (нужна GPU, CUDA, обслуживание).

Типовые сценарии:

• CRM и HR-системы — автоматическая транскрипция звонков клиентам, собеседований с кандидатами
• Платформы для подкастеров — генерация шоу-нот и субтитров при загрузке нового эпизода
• Сервисы конференций — Zoom/RuTube/Контур.Толк интеграции для авто-протоколов встреч
• EdTech — субтитры к курсам, конспекты лекций для обучающихся
• LegalTech — расшифровка консультаций в адвокатских CRM
• Доступность — субтитры для медиа-контента в СМИ и пабликах

Минимальная интеграция за 15 минут

1. Получите API-ключ

Откройте Telegram-бот @DeepScribe_bot → /api → «Создать ключ» → сохраните dsk_live_.... Один аккаунт может иметь до 10 ключей одновременно.

2. Загрузите аудио

# Python (requests)
import requests

with open('interview.mp3', 'rb') as f:
    r = requests.post(
        'https://deepscribe.ru/api/v1/jobs',
        headers={'Authorization': 'Bearer dsk_live_xxxxxxx'},
        files={'file': f},
        data={
            'output_formats': 'txt,srt,docx,json',
            'use_summary': 'true',
            'use_qwen_polish': 'true',
        },
    )

job_id = r.json()['id']  # → 12345

3. Дождитесь готовности (polling или webhook)

# Опция А: polling
import time

while True:
    status = requests.get(
        f'https://deepscribe.ru/api/v1/jobs/{job_id}',
        headers={'Authorization': 'Bearer dsk_live_xxxxxxx'},
    ).json()

    if status['status'] == 'done':
        break
    if status['status'] == 'failed':
        raise Exception(status['error_message'])

    time.sleep(5)  # 12 запросов / минуту — внутри лимита

4. Скачайте результаты

# TXT — обычный текст
txt = requests.get(
    f'https://deepscribe.ru/api/v1/jobs/{job_id}/result/txt',
    headers={'Authorization': 'Bearer dsk_live_xxxxxxx'},
).text

# JSON — полная структура с таймкодами и спикерами
data = requests.get(
    f'https://deepscribe.ru/api/v1/jobs/{job_id}/result/json',
    headers={'Authorization': 'Bearer dsk_live_xxxxxxx'},
).json()

# DOCX — готовый Word-документ
docx_bytes = requests.get(
    f'https://deepscribe.ru/api/v1/jobs/{job_id}/result/docx',
    headers={'Authorization': 'Bearer dsk_live_xxxxxxx'},
).content

Webhooks с retry — для production-интеграции

Не хотите делать polling? Включите webhooks: DeepScribe сам POST'нет ваш URL когда задача готова. С retry и подписью — всё что нужно для надёжной production-интеграции.

Регистрация webhook'а:

POST /api/v1/webhooks
Authorization: Bearer dsk_live_xxxxxxx
Content-Type: application/json

{
    "url": "https://your-app.example.com/deepscribe-callback",
    "events": ["job_done", "job_failed"]
}

Что приходит на ваш URL:

POST https://your-app.example.com/deepscribe-callback
X-DeepScribe-Signature: sha256=abc123...
X-DeepScribe-Event-Id: 550e8400-e29b-41d4-a716-446655440000
X-DeepScribe-Attempt: 1
Content-Type: application/json

{
    "event": "job_done",
    "event_id": "550e8400-...",
    "timestamp": "2026-05-22T12:34:56Z",
    "data": {
        "job_id": 12345,
        "filename": "interview.mp3",
        "duration_sec": 3600,
        "minutes_consumed": 60.0,
        "formats": ["txt", "srt", "docx", "json"]
    }
}

Гарантия доставки: at-least-once. Retry с exponential backoff (1с → 4с → 16с, всего 4 попытки). Дедупликация — по заголовку X-DeepScribe-Event-Id: один UUID на всех попытках, ваш клиент дедуплицирует.

Подпись: HMAC-SHA256 от тела ответа на ваш secret (генерируется при создании webhook'а). Проверка: hmac.new(secret, body, 'sha256').hexdigest() == header_value[7:].

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