API-Referenz

Transkription erstellen

Verwandle jede gehostete Mediendatei in präzise, zeitgestempelte Untertitel, ohne dass jemand das Studio öffnet — und speise dein CMS, dein Archiv oder deine Publishing-Pipeline direkt.

Genau eines von source_url und upload_id ist erforderlich.

Die Mediendauer wird vor Annahme der Anfrage ermittelt; Guthaben-Abbuchung und Einreihen des Jobs erfolgen in einem atomaren Schritt. Gibt 201 mit der Transkriptions-Ressource zurück.

Credits: 4 Credits pro angefangener Medienminute, abgebucht bei Annahme des Jobs. Fehlgeschlagene Jobs werden automatisch erstattet.

curl -X POST https://api.inwista.ai/v1/transcriptions \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.example.com/interview.mp4",
    "language": "en",
    "diarization": true
  }'

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "upload_id": null,
  "temperature": 0,
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Transkriptionen auflisten

Gleiche deinen Katalog mit den verarbeiteten Jobs ab oder baue ein Dashboard über alles, was du transkribiert hast.

Über die API erstellte Transkriptionen, neueste zuerst. Standard-Paginierung.

Credits: Kostenlos.

curl "https://api.inwista.ai/v1/transcriptions?limit=10" \
  -H "Authorization: Bearer inw_live_…"

Transkription abrufen

Fortschritts-Poll und Endergebnis in einem: Beobachte, wie der Status auf completed wechselt, und lies dann Dauer, Sprache und Abbuchung aus derselben Antwort.

Polle, bis der Status completed ist (oder registriere einen Webhook, siehe unten). Das Lesen einer fehlgeschlagenen Transkription löst zugleich ihre automatische Erstattung aus.

Credits: Kostenlos.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "upload_id": null,
  "temperature": 0,
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Eine Transkription löschen

Löschen Sie einen Auftrag auf Abruf — volle Datenkontrolle mit einem einzigen Aufruf.

Löscht die Transkription dauerhaft mit allem, was dafür gespeichert wurde: Mediendateien, Transkriptionsinhalt, Revisionen, Übersetzungen und Kommentare. Aggregierte Abrechnungszähler bleiben erhalten — sie enthalten keine Inhalte.

Nur abgeschlossene oder fehlgeschlagene Aufträge können gelöscht werden; ein noch laufender Auftrag liefert 409, ebenso einer mit laufender Verbesserung oder Übersetzung. Die Löschung ist sofort und unwiderruflich.

Credits: endpoints.delete-transcription.pricing

curl -X DELETE https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "deleted": true
}

Untertitel abrufen

Hole sendefertige Untertiteldateien direkt in deinen Player, dein MAM oder deine Delivery-Pipeline — keine manuellen Exporte, keine Formatkonvertierung auf deiner Seite. In einer Videoproduktions-Pipeline landet fertiges SRT oder VTT direkt in deinem NLE, Review-Tool oder Packaging-Schritt, sobald ein Schnitt transkribiert ist.

Gibt den rohen Inhalt der Untertiteldatei mit passendem Content-Type zurück — nicht in JSON verpackt. Antwortet mit 409 not_ready, bis die Transkription abgeschlossen ist.

Credits: Kostenlos.

curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=srt" \
  -H "Authorization: Bearer inw_live_…" -o interview.srt

Das json-Format ist ein versionierter Vertrag: { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — Sekunden mit Millisekunden-Präzision, Felder werden innerhalb einer Version nur ergänzt, nie entfernt.

Übersetzungen gehören zu der Version, für die sie erstellt wurden — die revision_id der Übersetzungsressource benennt sie, und die Version einer späteren Verbesserung erbt sie nicht. Übergeben Sie diese revision_id als revision, um die übersetzte Version abzurufen.

Upload erstellen

Transkribiere eine Datei direkt aus einer Desktop-App, einem Schnitt-Plugin oder von einem privaten Server, ohne sie vorher irgendwo öffentlich zu hosten.

Gibt 201 mit der Upload-Ressource zurück. Die signierte URL ist vier Stunden gültig und an die Header in upload_headers gebunden: Sende sie beim PUT genau so, wie sie zurückgegeben wurden, sonst weist der Speicher die Anfrage ab. Der length-range-Header setzt die Grenze von 4 GB durch.

Idempotency-Key wird berücksichtigt, ein wiederholtes Erstellen liefert also denselben Upload erneut, statt einen zweiten Slot anzulegen.

Credits: Kostenlos. Credits werden zum Transkriptionssatz abgebucht, sobald der Upload als Transkription übermittelt wird.

# 1. Create the upload
curl -X POST https://api.inwista.ai/v1/uploads \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "filename": "interview.m4a", "content_type": "audio/mp4" }'

# 2. PUT the file to upload_url with upload_headers
curl -X PUT "<upload_url>" \
  -H "Content-Type: audio/mp4" \
  -H "x-goog-content-length-range: 0,4294967296" \
  -H "x-goog-if-generation-match: 0" \
  --data-binary @interview.m4a

# 3. Submit it
curl -X POST https://api.inwista.ai/v1/transcriptions \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "upload_id": "7hKq2mZp…", "language": "en" }'

{
  "id": "7hKq2mZp…",
  "object": "upload",
  "status": "pending",
  "filename": "interview.m4a",
  "content_type": "audio/mp4",
  "size_bytes": 84213770,
  "transcription_id": null,
  "created": 1754558000,
  "upload_url": "https://storage.googleapis.com/…",
  "upload_method": "PUT",
  "upload_headers": {
    "Content-Type": "audio/mp4",
    "x-goog-content-length-range": "0,4294967296",
    "x-goog-if-generation-match": "0"
  },
  "upload_url_expires_at": 1754572400
}

Audio reicht für die Transkription: Exportierst du nur die Tonspur, bleibt ein abendfüllender Spielfilm unter 100 MB.

Ein Upload wird zu genau einer Transkription. Erneutes Übermitteln antwortet mit 409 upload_already_used.

Upload abrufen

Prüfe, ob eine Datei schon übermittelt wurde und zu welcher Transkription sie geworden ist.

Die Upload-Ressource ohne die einmaligen Upload-Felder. status steht auf consumed und transcription_id ist gesetzt, sobald der Upload übermittelt wurde.

Credits: Kostenlos.

curl https://api.inwista.ai/v1/uploads/7hKq2mZp… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "7hKq2mZp…",
  "object": "upload",
  "status": "consumed",
  "filename": "interview.m4a",
  "content_type": "audio/mp4",
  "size_bytes": 84213770,
  "transcription_id": "aB3dE9f2…",
  "created": 1754558000
}

Verbesserung starten

Broadcast-taugliches Timing und Zeilenausgleich auf Autopilot — liefere Untertitel aus, die die QC bestehen, ohne dass jemand sie von Hand nachbearbeitet. Für Produktionshäuser automatisiert das den Untertitel-Conform-Schritt der Delivery-Pipeline: Jede Episode geht mit konsistenten, spezifikationskonformen Untertiteln raus.

Gibt 202 mit der Verbesserungs-Ressource zurück.

Credits: Berechnet aus der Größe des Untertitelinhalts zu denselben Sätzen wie im Studio, abgebucht bei Annahme des Jobs. Bei Fehlschlag automatische Erstattung.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhance \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "settings": { "maxCharactersPerLine": 37, "textCondensation": "smart" } }'

{
  "id": "rev8Xk3…",
  "object": "enhancement",
  "transcription_id": "aB3dE9f2…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 12,
  "error": null,
  "created": 1754559000
}

Verbesserung abrufen

Poll und Ergebnis in einem: Sobald der Status completed meldet, liefert der Captions-Endpunkt bereits die verbesserte Version.

Polle bis completed. Das Lesen einer fehlgeschlagenen Verbesserung löst ihre automatische Erstattung aus.

Credits: Kostenlos.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhancements/rev8Xk3… \
  -H "Authorization: Bearer inw_live_…"

Übersetzung starten

Ein Aufruf pro Sprache macht aus einer fertigen Untertitelspur eine lokalisierte Version mit identischem Timing — vervielfache die Reichweite jedes Videos, das du bereits hast.

Gibt 202 zurück. Antwortet mit 409 translation_exists, wenn diese Sprache für die aktuelle Version bereits existiert.

Credits: Berechnet aus der Größe des Untertitelinhalts zu denselben Sätzen wie im Studio, pro Zielsprache, abgebucht bei Annahme. Bei Fehlschlag automatische Erstattung.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translate \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "target_language": "es" }'

{
  "id": "es",
  "object": "translation",
  "transcription_id": "aB3dE9f2…",
  "target_language": "es",
  "revision_id": "TRkf2nY7…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 6,
  "error": null,
  "created": 1754559600
}

Übersetzung abrufen

Poll und Ergebnis in einem: Sobald sie completed ist, holst du die übersetzte Untertiteldatei mit dem language-Parameter vom Captions-Endpunkt.

Polle bis completed und rufe die übersetzten Untertitel dann mit dem language-Query-Parameter vom Captions-Endpunkt ab.

Credits: Kostenlos.

# Poll the translation resource
curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translations/es \
  -H "Authorization: Bearer inw_live_…"

# Once completed, fetch the translated subtitle file
curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=vtt&language=es" \
  -H "Authorization: Bearer inw_live_…" -o interview-es.vtt