ElevenAPIDubbingLanguage targets

Utwórz język docelowy dubbingu

Dodaje język dubbingu do projektu i umieszcza dubbing w kolejce. To wywołanie tworzy zdubbingowane audio i jest rozliczane za każdą generację. Cel otrzymuje status `queued` i zaczyna się, gdy projekt uzyska status `ready`, więc możesz go dodać w dowolnym momencie po utworzeniu projektu. Dziedziczy model dubbingu projektu i nie może wybrać innego. Projekt utworzony z `webhook_ids` wysyła zdarzenie `dubbing_language_completed` z adresami URL do pobrania wyników, dlatego zalecamy subskrypcję zamiast odpytywania tego celu aż do ukończenia.

Parametry ścieżki

project_idstringWymagany

Identyfikator nadrzędnego projektu dubbingu.

Nagłówki

xi-api-keystringOpcjonalny

Żądanie

This endpoint expects an object.
target_languagestringWymagany

Tag językowy BCP-47 języka dubbingu projektu (np. fr lub es-MX). Musi to być jeden z języków obsługiwanych przez model dubbingu projektu, a tag z określonym regionem musi wskazywać jeden z obsługiwanych dialektów.

voice_settingsobject or nullOpcjonalny

Ustawienia głosu stosowane do każdego mówcy w tym języku. Pomiń, aby użyć wartości domyślnych.

translationsmap from strings to strings or nullOpcjonalny

Tylko Enterprise. Opcjonalne tłumaczenia używane zamiast tłumaczenia maszynowego. Mapa od external_id każdego segmentu źródłowego (lub jego id, jeśli go nie podano) do przetłumaczonego tekstu; każdy segment źródłowy musi wystąpić dokładnie raz. Maksymalnie 20 000 wpisów o łącznym rozmiarze tekstu do 4 MiB. Zobacz Użyj własnej transkrypcji.

Odpowiedź

Pomyślna odpowiedź

language_idstring

Unikalny identyfikator języka docelowego.

project_idstring

Identyfikator nadrzędnego projektu dubbingu.

target_languagestring

Tag językowy BCP-47 języka dubbingu tego celu.

statusenum

Status cyklu życia: queued (oczekiwanie na gotowość projektu lub workera), processing podczas dubbingu, completed po udostępnieniu wyniku, stale gdy transkrypcja zmieniła się po wygenerowaniu wyniku, lub failed.

Dozwolone wartości:
revisioninteger

Licznik monotoniczny zwiększany przy każdej zmianie transkrypcji tego celu (edycji źródła, która na nią wpływa, lub edycji tłumaczenia).

created_atstringformat: "date-time"

Kiedy utworzono docelowy język.

updated_atstringformat: "date-time"

Kiedy ostatnio zaktualizowano docelowy język.

model_idstring or nullOpcjonalny

Model dubbingu używany dla tego języka docelowego, dziedziczony z projektu i niewybieralny dla poszczególnych języków.

voice_settingsobject or nullOpcjonalny

Ustawienia głosu stosowane do każdego mówcy w tym języku lub null, jeśli obowiązują wartości domyślne.

outputsobject or nullOpcjonalny

Podpisane adresy URL wyjścia; null, dopóki materiał docelowy nie wygeneruje wyjścia (dostępne po completed i zachowane przy stale — porównaj output_revision z revision, aby sprawdzić, czy wyjście jest aktualne).

output_revisioninteger or nullOpcjonalny

revision, z której wygenerowano bieżące zdubbingowane wyjście; jest równa revision, gdy wyjście jest aktualne, i niższa, gdy ma status stale. Do ukończenia generowania ma wartość null.

errorobject or nullOpcjonalny

Dlaczego przetwarzanie tego języka się nie powiodło; null, chyba że status ma wartość failed, a także null dla nielicznych języków, których przetwarzanie nie powiodło się przed wprowadzeniem raportowania błędów. Kod project_failed oznacza, że nie powiódł się projekt nadrzędny, więc sprawdź projekt, aby poznać przyczynę.

warningslist of objectsOpcjonalny

Niekrytyczne problemy występujące podczas dubbingu w tym języku; jeśli ich nie ma, lista jest pusta. Odzwierciedla najnowszą generację. Problemy podczas przygotowania źródła są zgłaszane w projekcie.

Błędy

422
Unprocessable Entity Error