Schnellstart

Diese Anleitung fuehrt durch den vollstaendigen API-Ablauf: Upload erstellen, Mediendatei senden, Upload abschliessen, Transkriptionsaufgabe erstellen und Ergebnisse abfragen.

Besuchen Sie Video To Text, um Ihr Konto zu verwalten, API-Schluessel zu erstellen und zum Produkt-Workspace zurueckzukehren.

Setzen Sie die API-Basis-URL und den Schluessel:

export VTT_API_BASE_URL="https://api.videototext.dev"
export VTT_API_KEY="vtt_xxxxx"

1. Upload erstellen

Erstellen Sie eine signierte Upload-URL fuer die Mediendatei.

curl -X POST "https://api.videototext.dev/v1/uploads" \
  -H "Authorization: Bearer $VTT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "meeting.mp4",
    "mimetype": "video/mp4"
  }'

Die Antwort enthaelt die Felder, die fuer die naechsten Schritte benoetigt werden:

{
  "data": {
    "uploadUrl": "https://storage.example.com/signed-upload-url",
    "fileKey": "uploads/example.mp4",
    "fileUrl": "https://static.example.com/uploads/example.mp4",
    "uploadId": "00000000-0000-0000-0000-000000000000",
    "expiresAt": "2026-06-06T10:00:00.000Z"
  },
  "meta": {}
}

2. Datei hochladen

Laden Sie die binaere Datei direkt zu uploadUrl hoch. Verwenden Sie denselben Content-Type-Wert, der beim Erstellen des Uploads angegeben wurde.

curl -X PUT "https://storage.example.com/signed-upload-url" \
  -H "Content-Type: video/mp4" \
  --data-binary "@meeting.mp4"

3. Upload abschliessen

Schliessen Sie die Upload-Sitzung ab, damit Video To Text das Objekt validieren und ein Asset erstellen kann.

curl -X POST "https://api.videototext.dev/v1/uploads/$UPLOAD_ID/operations/complete" \
  -H "Authorization: Bearer $VTT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileKey": "uploads/example.mp4",
    "fileUrl": "https://static.example.com/uploads/example.mp4",
    "filename": "meeting.mp4",
    "mimetype": "video/mp4",
    "fileSize": 10485760
  }'

Die Antwort gibt die assetId zurueck, mit der eine Transkriptionsaufgabe erstellt wird.

{
  "data": {
    "assetId": "00000000-0000-0000-0000-000000000000"
  },
  "meta": {}
}

4. Transkriptionsaufgabe erstellen

Erstellen Sie die Aufgabe aus dem hochgeladenen Asset. Der Standardmodus ist balanced.

curl -X POST "https://api.videototext.dev/v1/tasks" \
  -H "Authorization: Bearer $VTT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assetId": "00000000-0000-0000-0000-000000000000",
    "language": "Auto",
    "timestampMode": "CHUNK",
    "transcriptionMode": "balanced"
  }'

Verwenden Sie precision, wenn der Workflow Genauigkeit hoeher priorisiert als Kosten.

Die Antwort gibt data.task.transcriptId zurueck; verwenden Sie diesen Wert beim Polling als TASK_ID.

Modus	Am besten fuer
balanced	Schnelle, kosteneffiziente Transkription fuer die meisten Produktions-Workflows.
precision	Transkription mit hoeherer Genauigkeit, wenn Qualitaet wichtiger ist als Kosten.

5. Aufgabe abfragen

Fragen Sie den Aufgaben-Endpunkt ab, bis status zu SUCCEEDED, FAILED oder CANCELED wird.

curl "https://api.videototext.dev/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $VTT_API_KEY"

Erfolgreiche Aufgaben geben Transkripttext, oeffentliche Timing-Felder fuer Abschnitte, Wort-Timestamps, Details zur Quelldatei und abgerechnete Credits zurueck.