▶Содержание API

Документация Votxt OpenAPI

Бета Votxt OpenAPI сейчас в бета-версии. Проверьте интеграцию в среде разработки перед продакшеном.

Обзор

Votxt OpenAPI позволяет встроить транскрибацию аудио и видео в приложения и автоматизации.

Загрузите файл или используйте внешний URL, затем создайте задачу транскрибации и проверьте статус.

После завершения экспортируйте текст, субтитры и структурированные данные в нескольких форматах.

Базовый URL

https://api.votxt.co

Аутентификация

Передавайте API-ключ в заголовке запроса. Для доступа API нужен активный план с поддержкой API.

X-API-Key: your_api_key_here

Откройте настройки аккаунта.
Убедитесь, что ваш план включает доступ API.
Создайте API-ключ и храните его безопасно.

Загрузка файлов

Используйте прямую загрузку через подписанные URL или публичный внешний URL файла.

POST /api/v1/files/upload-url
PUT upload_url
POST /api/v1/transcriptions

POST /api/v1/files/upload-url
Content-Type: application/json
X-API-Key: your_api_key

{
  "filename": "audio.mp3",
  "file_size": 1048576,
  "upload_expires_in": 3600,
  "download_expires_in": 1800
}

Транскрибация

Эндпоинт	Метод	Описание
/api/v1/transcriptions	POST	Загрузка файлов
/api/v1/transcriptions/youtube	POST	YouTube
/api/v1/transcriptions	GET	Транскрипции
/api/v1/transcriptions/{id}	GET	Транскрипт
/api/v1/transcriptions/{id}/status	GET	Статус

POST /api/v1/transcriptions
Content-Type: application/json
X-API-Key: your_api_key

{
  "file_key": "12345-abc123def456.mp3",
  "filename": "audio.mp3",
  "language_code": "en",
  "transcription_type": "transcript",
  "enable_speaker_diarization": false,
  "webhook_url": "https://your-app.com/webhook"
}

Статус

Статус	Транскрибация
queued	В очереди
preprocessing	Предобработка
processing	Обработка
completed	Завершено
failed	Ошибка

Экспорт