Общая информация и возможности

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

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

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

Общий флоу

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

Ограничения:

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

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

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