Eingaben
Medien und Sprachen
Quellen für Untertiteltext
Verwenden Sie diese Felder, wenn Sie ursprünglichen oder übersetzten Untertiteltext angeben möchten. Andernfalls können Sie diesen Abschnitt ignorieren.Übersetzung und Synchronisation
Verwenden Sie diese Felder, um Übersetzungs- und Synchronisationsmodelle, Einstellungen oder Anforderungen anzupassen. Andernfalls können Sie diesen Abschnitt ignorieren.| Feld | Werte | Anforderung | Beschreibung |
|---|---|---|---|
speaker_number | { min, max } | Optional | Gibt den erwarteten Bereich der Sprecheranzahl an. min muss mindestens 1 sein und max darf 35 nicht überschreiten. Für die automatische Erkennung weglassen. |
voice_model | auto, real, native | Optional | Wählt das für die Synchronisation verwendete Stimmenklonmodell aus. Standard ist auto: auto wählt automatisch das beste Modell für Ihren Inhalt aus; real verwendet VoiceREAL, um Emotion und Akzent der Originalstimme beizubehalten; native verwendet VoiceNATIVE, um einen natürlicheren Akzent in der Zielsprache zu liefern. |
selected_voice_id | String | Optional | Verwendet eine bestimmte Stimme aus der Voice Library in der Vozo-Web-App für die Synchronisation. Wenn dieses Feld angegeben wird, überschreibt es voice_model: Die API überspringt das automatische Stimmenklonen und verwendet die ausgewählte Stimme, um das synchronisierte Audio zu erzeugen. |
align_video | Boolean | Optional; nur Video | Wenn auf true gesetzt, wird die Videogeschwindigkeit automatisch angepasst, damit das übersetzte Audio und das Video durchgehend synchron bleiben. Standard ist false. Setzen Sie es auf false, wenn das übersetzte Audio als zusätzliche Audiospur auf YouTube verwendet wird. |
glossary_ids | Array mit bis zu 3 IDs | Optional | Wendet in der Vozo-Web-App erstellte Glossare an, um die Terminologie konsistent zu halten.  |
user_prompt | String | Optional | Bietet Anweisungen für die Übersetzung oder Synchronisation, z. B. zu Ton, Stil oder Terminologiepräferenzen. |
Untertitelausgabe
Verwenden Sie diese Felder, wenn Sie dem Video übersetzte Untertitel hinzufügen oder bestehende Untertitel löschen und ersetzen möchten. Andernfalls können Sie diesen Abschnitt ignorieren.| Feld | Werte | Anforderung | Beschreibung |
|---|---|---|---|
subtitle_mode | none, add, replace | Optional | Steuert das Rendern von Untertiteln: keine Untertitel rendern, übersetzte Untertitel hinzufügen oder bestehende Untertitel löschen, bevor übersetzte Untertitel gerendert werden. Standard ist none. |
subtitle_style_id | String | Optional; gilt mit add oder replace | Wendet einen Untertitelstil an, der aus einem Projekt in der Vozo-Web-App kopiert wurde. Wenn nicht angegeben, wird der integrierte Standard-Untertitelstil verwendet.  |
subtitle_position_y | Zahl von 0 bis 1 | Optional; gilt mit add oder replace | Legt die vertikale Untertitelposition fest, von oben (0) bis unten (1). Zum Beispiel platziert 0,75 Untertitel bei 75 % der Videohöhe. Siehe die unten stehenden Standardregeln für die Positionierung, wenn dieses Feld nicht angegeben wird. |
Wenn
subtitle_style_id nicht angegeben wird, wird der integrierte Standardstil verwendet. Er zeigt eine einzelne zentrierte Zeile mit weißem Noto Sans Medium-Text in Schriftgröße 14, einer schwarzen Außenkontur und einem dezenten schwarzen Schatten an. Die Untertitelbreite beträgt 80 % des Videos, ohne Hintergrund, Aktivwort-Effekt oder Übergang.Wenn subtitle_position_y nicht angegeben wird, stammt sein Wert nicht aus dem ausgewählten Untertitelstil. Die Position wird durch subtitle_mode bestimmt:- Für
addist der Standardwert0,9für Querformat- und quadratische Videos und0,75für Hochformatvideos. - Für
replacewerden Untertitel an der ursprünglichen Untertitelposition platziert.
Projekt und Ausgabe
Ausgaben
(abhängig vonexport_type, project_mode und enable_proofreading):
- URL des übersetzten Videos und/oder Audios
- übersetzte
subtitle_url(SRT) project_url, wenn ein Projekt im Web-Dashboard erstellt wird
So funktioniert es
1
Stellen Sie Ihre Assets unter einer öffentlich zugänglichen URL bereit
Laden Sie Ihr Video oder Audio zusammen mit allen optionalen Assets hoch, damit unsere Server darauf zugreifen können.
2
Senden Sie eine API-Anfrage
Geben Sie die erforderlichen Eingaben und alle optionalen Einstellungen an, die für den Job benötigt werden.
3
Warten oder Status abfragen
Verwenden Sie unseren Webhook-Callback oder fragen Sie die API mit Ihrer Task-ID ab, bis die Verarbeitung abgeschlossen ist.
4
Ausgaben herunterladen
Rufen Sie das übersetzte Video/Audio und die übersetzten Untertitel (.srt) über die bereitgestellten URLs ab.
Nutzungseinschränkung
- Nur Benutzer, die API-Schlüssel erstellen können, dürfen diese API verwenden.
- Der Studio-Plan ist erforderlich; Nicht-Studio-Benutzer sind nicht zugelassen.
- Das Standardlimit für gleichzeitige Vorgänge beträgt 10 Jobs. Dieses Limit wird von allen Mitgliedern eines Teams gemeinsam genutzt. Siehe Limits für gleichzeitige Vorgänge für Details.
- Der Sprachcode folgt dem IETF-BCP-47-Standard, z. B. en‑US.