▶Зміст 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	Помилка

Експорт