For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Erstellen Sie ein Synchronisationsprojekt aus einer hochgeladenen Datei (`file`) oder einer Quell-URL (`source_url`).
Gibt zurück, sobald der Projektdatensatz existiert, bevor die Quelle abgerufen wurde: Das Projekt startet als `queued` und erreicht `ready`, sobald seine Quelle transkribiert wurde. Fügen Sie für jede gewünschte Sprache ein Sprachziel hinzu oder übergeben Sie `target_language`, um hier das erste Ziel in die Warteschlange einzureihen.
Für das Erstellen eines Projekts fällt mindestens eine Sprache als Gebühr an: Beim Erstellen des Projekts wird die Synchronisation für mindestens eine Sprache berechnet, bevor Ausgaben vorhanden sind. Diese Gebühr bezahlt das erste Sprachziel im Voraus – das erste Ziel, das Sie hinzufügen oder über `target_language` in die Warteschlange einreihen, verbraucht sie – und jede weitere Sprache wird separat berechnet.
Die Vorbereitung kann bei einer langen Quelle mehrere Minuten dauern. Daher empfehlen wir, `webhook_ids` zu übergeben, um benachrichtigt zu werden, wenn das Projekt `ready` oder `failed` wird, statt den Status regelmäßig abzufragen.
Header
xi-api-keystringOptional
Anfrage
This endpoint expects a multipart form with multiple files.
filefileOptional
Die zu synchronisierende Quelldatei: eine Audio- oder Videodatei mit maximal 3 GiB. Geben Sie diese Datei oder source_url an, nicht beides.
source_urlstring or nullOptional
Öffentliche HTTP(S)-URL, von der das Quellmedium serverseitig abgerufen wird. Es gelten dieselben Größen- und Formatbeschränkungen wie für Uploads. Geben Sie diese oder file an, nicht beides.
referencestring or nullOptional
Optionaler Freitext (maximal 500 Zeichen), um das Projekt auf Ihrer Seite zu identifizieren. Wird unverändert gespeichert und zurückgegeben; er beeinflusst die Synchronisierung nicht.
source_languagestring or nullOptional
BCP-47-Sprach-Tag der Quellmedien; muss eine vom Transkriptionsmodell unterstützte Sprache sein. Subtags für Region oder Schrift werden ignoriert, da die Transkription sprachbasiert erfolgt. Für automatische Erkennung weglassen.
model_idenum or string or nullOptional
Synchronisierungsmodell (`dubbing_v1` oder `dubbing_v2`), mit dem jedes Sprachziel dieses Projekts synchronisiert wird. Standard ist `dubbing_v2`. Bei der Erstellung festgelegt – die Quelle wird für dieses Modell vorbereitet, daher können weder das Projekt noch ein einzelnes Ziel es später ändern.
keytermslist of stringsOptional
Schlüsselbegriffe, auf die Transkription und Übersetzung ausgerichtet werden sollen, z. B. Produkt- oder Markennamen. Maximal 1.000 Begriffe; jeder Begriff maximal 50 Zeichen und 5 Wörter; die Zeichen `<>{}[]\` sind nicht erlaubt. Begriffe werden bereinigt und dedupliziert. Wiederholen Sie das Feld einmal pro Begriff oder übergeben Sie ein einzelnes JSON-Array.
webhook_idslist of stringsOptional
IDs der Workspace-Webhooks, die benachrichtigt werden, während dieses Projekt fortschreitet — die Alternative zum Polling, die wir empfehlen. Jeder erhält für das Projekt ein `dubbing_project_ready`- oder `dubbing_project_failed`-Ereignis sowie für jede darin enthaltene Sprache ein `dubbing_language_completed`- oder `dubbing_language_failed`-Ereignis. `dubbing_language_completed` enthält die Download-URLs für die Ausgabe. Maximal 3 IDs, die jeweils bereits in Ihrem Workspace konfiguriert sind — unter [Webhooks](https://elevenlabs.io/docs/eleven-api/resources/webhooks) erfahren Sie, wie Sie einen Webhook erstellen und seine Signatur prüfen. Wiederholen Sie das Feld einmal pro ID oder übergeben Sie ein einzelnes JSON-Array oder eine kommagetrennte Zeichenfolge. Die Zustellung erfolgt nach bestem Bemühen und kann sich wiederholen. Wir empfehlen daher, Ereignisse idempotent zu verarbeiten.
target_languagestring or nullOptional
Optionale Abkürzung: Erstellen Sie zusätzlich ein Sprachziel in dieser BCP-47-Sprache, das startet, sobald das Projekt bereit ist. Dies entspricht dem Erstellen des Projekts und anschließend eines Sprachziels. Die Sprache muss zu den [vom Synchronisierungsmodell unterstützten Sprachen](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing) gehören, und ein regionsspezifisches Tag muss einem der unterstützten Dialekte entsprechen. Dies ist das erste Sprachziel und verbraucht daher die Mindestgebühr des Projekts, statt sie zu erhöhen. Seine ID wird in `language_ids` zurückgegeben.
transcriptfileOptional
Nur Enterprise. Optionales JSON-Transkript zur Verwendung anstelle der Transkription der Quelle: ein `{"segments": [...]}`-Dokument mit maximal 20.000 Segmenten und 4 MiB. Informationen zu Segmentfeldern und ihren Einschränkungen finden Sie unter [Eigenes Transkript verwenden](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript). `source_language` ist erforderlich, wenn ein Transkript bereitgestellt wird. Wenn ein Segment eine `translation` enthält, ist `target_language` erforderlich und jedes Segment muss eine enthalten. Diese Übersetzungen initialisieren das über `target_language` erstellte Ziel, das dann die maschinelle Übersetzung überspringt.
Antwort
Erfolgreiche Antwort
project_idstring
Eindeutige Kennung des Synchronisationsprojekts.
statusenum
Lebenszyklusstatus des Projekts: queued, bevor die Quelle verarbeitet wird, preparing während der Transkription, ready, sobald die Transkription abgeschlossen ist und Sprachziele starten können, oder failed. Ein Projekt wird nie als processing gemeldet – dieser Wert gehört zu Sprachzielen.
Erlaubte Werte:
revisioninteger
Monotoner Zähler, der bei jeder Bearbeitung des Quelltranskripts erhöht wird (Segment hinzufügen/bearbeiten/löschen).
created_atstringFormat: "date-time"
Zeitpunkt der Erstellung des Projekts.
updated_atstringFormat: "date-time"
Zeitpunkt der letzten Aktualisierung des Projekts.
referencestring or nullOptional
Die Freitextzeichenfolge, die Sie beim Erstellen des Projekts als reference angegeben haben, oder null, wenn Sie keine angegeben haben.
source_languagestring or nullOptional
BCP-47-Sprach-Tag der Quellmedien (null bei automatischer Erkennung).
model_idstring or nullOptional
Synchronisierungsmodell, mit dem jedes Sprachziel dieses Projekts synchronisiert wird. Bei der Erstellung festgelegt und nicht pro Sprache auswählbar.
mediaobject or nullOptional
Metadaten der Quellmedien, die ausgefüllt werden, sobald die Quelle abgerufen und dekodiert wurde (kurz nach create, bevor das Projekt ready ist); bis dahin null.
language_idslist of stringsOptionalStandardwert ist []
Kennungen der Sprachziele in diesem Projekt. Wird ausgefüllt, wenn ein einzelnes Projekt abgerufen wird, sowie beim Erstellen, wenn target_language ein Sprachziel erstellt. In Listenantworten stets leer — listen Sie stattdessen die Sprachziele des Projekts auf.
webhook_idslist of stringsOptionalStandardwert ist []
IDs der Workspace-Webhooks, die benachrichtigt werden, wenn dieses Projekt und seine Sprachen ready, completed oder failed erreichen.
errorobject or nullOptional
Warum das Projekt fehlgeschlagen ist; null, sofern status nicht failed ist. Auch null für die wenigen Projekte, die vor Einführung der Fehlerberichterstattung fehlgeschlagen sind.
warningslist of objectsOptional
Nicht schwerwiegende Bedingungen, die bei der Vorbereitung der Quelle aufgetreten sind; leer, wenn keine vorliegen. Spiegelt die neueste Vorbereitung wider. Bedingungen bei der Synchronisation einer bestimmten Sprache werden stattdessen für diese Sprache gemeldet.
Erstellen Sie ein Synchronisationsprojekt aus einer hochgeladenen Datei (file) oder einer Quell-URL (source_url).
Gibt zurück, sobald der Projektdatensatz existiert, bevor die Quelle abgerufen wurde: Das Projekt startet als queued und erreicht ready, sobald seine Quelle transkribiert wurde. Fügen Sie für jede gewünschte Sprache ein Sprachziel hinzu oder übergeben Sie target_language, um hier das erste Ziel in die Warteschlange einzureihen.
Für das Erstellen eines Projekts fällt mindestens eine Sprache als Gebühr an: Beim Erstellen des Projekts wird die Synchronisation für mindestens eine Sprache berechnet, bevor Ausgaben vorhanden sind. Diese Gebühr bezahlt das erste Sprachziel im Voraus – das erste Ziel, das Sie hinzufügen oder über target_language in die Warteschlange einreihen, verbraucht sie – und jede weitere Sprache wird separat berechnet.
Die Vorbereitung kann bei einer langen Quelle mehrere Minuten dauern. Daher empfehlen wir, webhook_ids zu übergeben, um benachrichtigt zu werden, wenn das Projekt ready oder failed wird, statt den Status regelmäßig abzufragen.
Synchronisierungsmodell (dubbing_v1 oder dubbing_v2), mit dem jedes Sprachziel dieses Projekts synchronisiert wird. Standard ist dubbing_v2. Bei der Erstellung festgelegt – die Quelle wird für dieses Modell vorbereitet, daher können weder das Projekt noch ein einzelnes Ziel es später ändern.
Schlüsselbegriffe, auf die Transkription und Übersetzung ausgerichtet werden sollen, z. B. Produkt- oder Markennamen. Maximal 1.000 Begriffe; jeder Begriff maximal 50 Zeichen und 5 Wörter; die Zeichen <>{}[]\ sind nicht erlaubt. Begriffe werden bereinigt und dedupliziert. Wiederholen Sie das Feld einmal pro Begriff oder übergeben Sie ein einzelnes JSON-Array.
IDs der Workspace-Webhooks, die benachrichtigt werden, während dieses Projekt fortschreitet — die Alternative zum Polling, die wir empfehlen. Jeder erhält für das Projekt ein dubbing_project_ready- oder dubbing_project_failed-Ereignis sowie für jede darin enthaltene Sprache ein dubbing_language_completed- oder dubbing_language_failed-Ereignis. dubbing_language_completed enthält die Download-URLs für die Ausgabe. Maximal 3 IDs, die jeweils bereits in Ihrem Workspace konfiguriert sind — unter Webhooks erfahren Sie, wie Sie einen Webhook erstellen und seine Signatur prüfen. Wiederholen Sie das Feld einmal pro ID oder übergeben Sie ein einzelnes JSON-Array oder eine kommagetrennte Zeichenfolge. Die Zustellung erfolgt nach bestem Bemühen und kann sich wiederholen. Wir empfehlen daher, Ereignisse idempotent zu verarbeiten.
Optionale Abkürzung: Erstellen Sie zusätzlich ein Sprachziel in dieser BCP-47-Sprache, das startet, sobald das Projekt bereit ist. Dies entspricht dem Erstellen des Projekts und anschließend eines Sprachziels. Die Sprache muss zu den vom Synchronisierungsmodell unterstützten Sprachen gehören, und ein regionsspezifisches Tag muss einem der unterstützten Dialekte entsprechen. Dies ist das erste Sprachziel und verbraucht daher die Mindestgebühr des Projekts, statt sie zu erhöhen. Seine ID wird in language_ids zurückgegeben.
Nur Enterprise. Optionales JSON-Transkript zur Verwendung anstelle der Transkription der Quelle: ein {"segments": [...]}-Dokument mit maximal 20.000 Segmenten und 4 MiB. Informationen zu Segmentfeldern und ihren Einschränkungen finden Sie unter Eigenes Transkript verwenden. source_language ist erforderlich, wenn ein Transkript bereitgestellt wird. Wenn ein Segment eine translation enthält, ist target_language erforderlich und jedes Segment muss eine enthalten. Diese Übersetzungen initialisieren das über target_language erstellte Ziel, das dann die maschinelle Übersetzung überspringt.
