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

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

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

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

Общий флоу

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

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

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

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

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