Video übersetzen, während du es transkribierst
Ergänze in der Anfrage, die die Transkription anlegt, translate_to, einen zweistelligen ISO 639-1-Code. wait wartet dann auch auf die Übersetzung. Die Übersetzungsanleitung behandelt Uploads und MCP.
Das Transkript entsteht wie gewohnt aus dem gesprochenen Audio oder den Untertiteln der Plattform. Die Übersetzung läuft danach auf diesem Text. Das Original ist also immer vorhanden und lesbar, auch wenn die Übersetzung noch nicht fertig ist.
Pro Anfrage ist nur eine Zielsprache möglich. Für eine zweite Sprache übersetzt du dasselbe Transkript nach dem Abschluss erneut.
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"}'Ein vorhandenes Transkript übersetzen
Sende die Sprache per POST an die Transkription. Die API antwortet mit 202 und dem Status der Übersetzung. Frage die Transkription ab oder nutze einen Webhook. Die Statuscodes stehen unter Übersetzung.
Die Transkription muss abgeschlossen sein, sonst liefert die API transcript_not_ready. Eine Wiederholung ist unbedenklich: Eine laufende oder fertige Übersetzung wird unverändert zurückgegeben, eine fehlgeschlagene wird erneut gestartet.
Webhooks melden transcription.translation.completed oder transcription.translation.failed. Deine Anwendung muss also nicht ständig nachfragen.
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"}'Zweisprachig, nur übersetzt oder nur Original
Hänge translation=both, only oder none an GET /v1/transcriptions/:id oder an einen Download als Text, SRT oder VTT an. Standard ist both.
Bei both enthalten die JSON-Segmente ein Feld translation, der Text zeigt die übersetzte Zeile unter dem Original, und jeder SRT- oder VTT-Block hat zwei Zeilen. Bei only ersetzt der übersetzte Text das Original, Zeitstempel und Sprecher bleiben gleich.
Die Antwort enthält außerdem ein Objekt translation mit der Sprache und dem Status processing, completed oder failed. Ein anderes Format eines fertigen Transkripts abzurufen kostet keine weiteren Minuten.
| translation | Das bekommst du |
|---|---|
| both | Original und Übersetzung zusammen, ein Paar pro Segment oder Block. |
| only | Der übersetzte Text statt des Originals, mit gleichem Timing. |
| none | Nur das Originaltranskript. |
Was die Übersetzung leistet und was nicht
Es handelt sich um eine maschinelle Übersetzung des Transkripttexts. Prüfe Namen, Fachbegriffe und Zitate vor der Veröffentlichung und behalte das Originaltranskript zum Vergleichen.
transcript1 synchronisiert kein Video und übersetzt keine Stimme. Es gibt kein übersetztes Audio, und Untertitel werden nicht ins Video eingebrannt. Du erhältst Text und Untertitel-Dateien für deinen eigenen Editor oder Player.
Die Übersetzung kostet keine Minuten. Transkriptionsminuten fallen wie gewohnt an, und eine fehlgeschlagene Übersetzung lässt das Transkript weder fehlschlagen noch erstattet sie es.