Synchronisation und Batch-Jobs
Die native API hinter der zeitlich abgestimmten Mehrsprecher-Synchronisation von VoiceStudio.
Synchronisation ist eine Pipeline aus Jobs, keine einzelne Anfrage. Transkription, Übersetzung, Stimmzuweisung, Timing, Generierung, Qualitätsprüfung und Export sind getrennte Schritte, die ein Client prüfen oder wiederholen kann.
Der Ablauf
POST /dub/uploadmit Video oder Audio.- Verfolge
/tasks/stream/{task_id}, bis die Vorbereitung bereit ist. - Transkribiere mit
/dub/transcribe-stream/{job_id}oder dem synchronen/dub/transcribe/{job_id}. - Übersetze und bearbeite die Segmente.
- Weise Profile zu und nutze
POST /dub/generate/{job_id}. - Prüfe QC, Vorschauen, Einzelspuren und Untertitel oder lade das Ergebnis herunter.
Der Upload gibt eine job_id für die Medien und eine task_id für den Vorbereitungsfortschritt zurück. Bewahre beide auf: Sie verfolgen unterschiedliche Dinge.
Was erhalten bleibt
- Start- und Endzeiten der Segmente
- Mehrere Sprecher mit jeweils eigener Stimme
- Importierte oder erzeugte SRT- und VTT-Untertitel
- Audio-only- und Video-Jobs
- Vorschau, QC, Einzelspuren und finaler Export
Nutze für einen Videoordner /batch/enqueue und /batch/jobs mit Status-, Abbruch- und Downloadrouten je Job.
Lokaler Ablauf
Diese Routen gehören zur Desktop-API. Der unveröffentlichte Cloud-Vertrag stellt Quellmedien als Artifact bereit und führt versionierte asynchrone Schritte aus; diese Pfade oder Payloads werden dort nicht zugesichert.
Jeder Schritt hat einen eigenen Anfrageinhalt. Nutze beim Erstellen eines Clients die API-Referenz als maßgebliche Quelle.