▶API-Inhalt

Votxt OpenAPI-Dokumentation

Beta Die Votxt OpenAPI ist in der Beta-Phase. Teste Integrationen vor dem Produktiveinsatz in einer Entwicklungsumgebung.

Uberblick

Mit der Votxt OpenAPI kannst du Audio- und Videotranskription in Apps und Automationen integrieren.

Lade eine Datei hoch oder nutze eine externe Datei-URL, erstelle danach eine Transkriptionsaufgabe und prufe den Status.

Nach Abschluss kannst du Transkripte, Untertitel und strukturierte Daten in mehreren Formaten exportieren.

Basis-URL

https://api.votxt.co

Authentifizierung

Sende deinen API-Schlussel im Request-Header. API-Zugriff erfordert einen aktiven API-fahigen Plan.

X-API-Key: your_api_key_here

Offne die Einstellungen deines Kontos.
Prufe, ob dein Plan API-Zugriff enthalt.
Erstelle einen API-Schlussel und speichere ihn sicher.

Dateiupload

Nutze direkten Upload uber signierte URLs oder eine extern erreichbare Datei-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
}

Transkription

Endpunkt	Methode	Beschreibung
/api/v1/transcriptions	POST	Dateiupload
/api/v1/transcriptions/youtube	POST	Videolink
/api/v1/transcriptions	GET	Transkriptionen
/api/v1/transcriptions/{id}	GET	Transkript-Editor
/api/v1/transcriptions/{id}/status	GET	Status

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"
}

Status

Status	Transkription
queued	In Warteschlange
preprocessing	Vorverarbeitung
processing	In Verarbeitung
completed	Abgeschlossen
failed	Fehlgeschlagen

Exporte