Общая информация

API позволяет удобно и безопасно выполнять транскрипцию аудио/видео, а также получать статистику использования и сведения о балансе.

Что можно делать

• Создавать транскрипции: прямая загрузка файла или по source_url
• Рассчитывать стоимость до создания задачи
• Проверять статус и получать результаты (ссылки на JSON/TXT/PDF)
• Запускать AI‑анализ по готовой транскрипции (в одном запросе с созданием)
• Список поддерживаемых AI‑моделей и чат — см. LLM
• Баланс и статистика использования (текущий баланс, кредитный лимит) — см. Баланс и статистика
• Вебхуки — уведомления о завершении транскрипции, ошибках, низком балансе и завершении LLM-запроса (см. Вебхуки)

Общий флоу

1. Вызвать метод POST /v2/transcriptions/calculate — предварительный расчёт стоимости (опционально). Контракт
2. Вызвать метод POST /v2/transcriptions — создание задания на транскрипцию. Если передать ai_prompt, дополнительно выполняется AI‑анализ. Транскрипция запускается в фоне; в ответе вернётся transcription_id для последующих запросов. Контракт
3. Проверить статус: GET /v2/transcriptions/{id} — где {id} — идентификатор транскрипции, полученный в ответе на запрос её создания. При недостатке средств вернётся ошибка биллинга. Контракт
4. (Опционально) LLM: список моделей и chat completions — раздел LLM.

Ограничения

• Вызов GET /v2/transcriptions/{id} допустим не чаще, чем 5 раз в минуту.
• Новое задание можно ставить в очередь только после финального статуса (Готово или Ошибка) предыдущего.

Безопасность

Доступ к защищённым эндпоинтам осуществляется по HMAC‑подписи через заголовки X-Public-Key, X-Timestamp, X-Signature. Подробнее — в разделе Аутентификация.