Übersetzung | transcript1 docs

transcript1 transkribiert die Medien zuerst und übersetzt den Transkripttext dann in eine Sprache deiner Wahl. Die Übersetzung wird pro Segment zugeordnet und behält die ursprünglichen Zeitstempel und Sprecher. Es ist reine Textübersetzung: keine Synchronisation und kein übersetztes Audio.

Die Übersetzung ist kostenlos. Sie verbraucht 0 Minuten und steht in deinem Nutzungsverlauf als kostenloser Eintrag "Translation". Transkriptionsminuten fallen wie gewohnt an. Eine fehlgeschlagene Übersetzung lässt das Transkript nie fehlschlagen und erstattet es nicht.

Beim Transkribieren übersetzen

Ergänze translate_to in der Anfrage, die die Transkription anlegt. Das ist ein zweistelliger ISO 639-1-Code in Kleinbuchstaben, etwa es oder en. Er funktioniert mit einem Videolink im JSON-Body von POST /v1/transcriptions, bei der Reservierung eines Chunk-Uploads und bei einem Multipart-Upload in einem Schritt.

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'

Bei einem Datei-Upload sendest du translate_to als Formularfeld:

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -F [email protected] \
  -F translate_to=en

Das MCP-Tool transcribe akzeptiert translate_to ebenfalls. Pro Anfrage gibt es eine Zielsprache.

Ein vorhandenes Transkript übersetzen

Fordere die Übersetzung einer abgeschlossenen Transkription an:

curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "en"}'

Die API antwortet mit 202:

{
  "transcription_id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
  "language": "en",
  "status": "processing"
}

Status	Bedeutung
`404`	Die Transkription wurde nicht gefunden.
`409 transcript_not_ready`	Die Transkription hat noch nicht den Status `completed`.
`422`	Die Sprache ist kein gültiger zweistelliger Code.

Der Aufruf ist idempotent. Eine Übersetzung mit processing oder completed wird unverändert zurückgegeben, eine mit failed wird erneut gestartet. Das MCP-Tool translate_transcription erwartet id und language.

Die Übersetzung abrufen

GET /v1/transcriptions/:id und die Downloads als Text, SRT und VTT akzeptieren translation:

`translation`	Ergebnis
`both` (Standard)	JSON-Segmente erhalten ein Feld `translation`. Der Text zeigt die übersetzte Zeile unter dem Original. SRT- und VTT-Blöcke haben zwei Zeilen: erst das Original, dann die Übersetzung.
`only`	Der übersetzte Text ersetzt `text`. Zeitstempel und Sprecher bleiben gleich.
`none`	Nur das Originaltranskript.

Die Antwort enthält ein Objekt translation, oder null, wenn keine Übersetzung angefordert wurde:

{
  "translation": { "language": "es", "status": "completed" }
}

status ist processing, completed oder failed. Bei einer fehlgeschlagenen Übersetzung steht zusätzlich eine error-Meldung. wait wartet auch auf eine angeforderte Übersetzung. Läuft die Wartezeit ab, lautet der Status processing. Das MCP-Tool get_transcription hat einen Parameter translation mit denselben Werten.

Webhooks

Zwei Events melden das Ergebnis einer Übersetzung, zusätzlich zu transcription.completed und transcription.failed, die sich nicht ändern:

`type`	Gesendet, wenn
`transcription.translation.completed`	Eine angeforderte Übersetzung `completed` erreicht hat.
`transcription.translation.failed`	Eine angeforderte Übersetzung `failed` erreicht hat.

data ist das Transkriptionsobjekt plus translation: { language, status, error }. Signaturen und Zustellregeln stehen unter Webhooks.