Vai alla navigazione

Crea lingua di destinazione per il doppiaggio

Aggiunge una lingua in cui doppiare un progetto e mette in coda il doppiaggio.

Questa chiamata produce l’audio doppiato e viene fatturata per generazione. La destinazione viene creata come queued e inizia non appena il progetto è ready, quindi può essere aggiunta in qualsiasi momento dopo la creazione del progetto. Eredita il modello di doppiaggio del progetto e non può selezionarne un altro.

Un progetto creato con webhook_ids invia un evento dubbing_language_completed contenente gli URL per il download dell’output; consigliamo quindi di sottoscrivere l’evento anziché eseguire il polling della destinazione fino al completamento.

Parametri di percorso

project_idstringObbligatorio
Identificatore del progetto di doppiaggio padre.

Header

xi-api-keystringOpzionale

Richiesta

This endpoint expects an object.
target_languagestringObbligatorio

Tag lingua BCP-47 in cui doppiare il progetto (ad esempio, fr o es-MX). Deve essere una delle lingue supportate dal modello di doppiaggio del progetto e un tag con regione deve corrispondere a uno dei dialetti supportati.

voice_settingsobject or nullOpzionale
Impostazioni vocali applicate a ogni parlante in questa lingua. Ometti per usare quelle predefinite.
translationsmap from strings to strings or nullOpzionale

Solo Enterprise. Traduzioni facoltative da usare al posto della traduzione automatica. Una mappa dall'external_id di ogni segmento di origine (o dal suo id, se non ne hai fornito uno) al testo tradotto; ogni segmento di origine deve essere incluso esattamente una volta. Al massimo 20.000 voci, per un totale massimo di 4 MiB di testo. Consulta Usa la tua trascrizione.

Risposta

Risposta riuscita
language_idstring
Identificatore univoco della lingua di destinazione.
project_idstring
Identificatore del progetto di doppiaggio padre.
target_languagestring

Tag lingua BCP-47 in cui questo target viene doppiato.

statusenum

Stato del ciclo di vita: queued (in attesa che il progetto sia pronto o di un worker), processing durante il doppiaggio, completed quando l'output è disponibile, stale quando la trascrizione è cambiata dopo la produzione dell'output, oppure failed.

Valori consentiti:
revisioninteger
Contatore monotono incrementato ogni volta che cambia la trascrizione di questa destinazione, in seguito a una modifica dell'origine che la interessa o a una modifica della sua traduzione.
created_atstringformat: "date-time"

Quando è stata creata la lingua di destinazione.

updated_atstringformat: "date-time"

Quando la lingua di destinazione è stata aggiornata l'ultima volta.

model_idstring or nullOpzionale
Modello di doppiaggio usato per doppiare questa destinazione, ereditato dal progetto e non selezionabile per lingua.
voice_settingsobject or nullOpzionale
Impostazioni vocali applicate a ogni parlante in questa lingua oppure null se si applicano le impostazioni predefinite.
outputsobject or nullOpzionale

URL di output firmati; null finché la destinazione non ha prodotto un output (presenti una volta completed e mantenuti mentre stale — confronta output_revision con revision per verificare se l'output è aggiornato).

output_revisioninteger or nullOpzionale

La revision da cui è stato generato l'attuale output doppiato; è uguale a revision quando è aggiornato e inferiore quando è stale. È null finché una generazione non viene completata.

errorobject or nullOpzionale

Motivo per cui questa lingua non è riuscita; null a meno che status non sia failed, ed è null anche per le poche lingue non riuscite prima dell'introduzione della segnalazione degli errori. Un codice project_failed indica che il progetto padre non è riuscito; consulta quindi il progetto per la causa sottostante.

warningslist of objectsOpzionale

Condizioni non fatali rilevate durante il doppiaggio in questa lingua; è vuoto se non ce ne sono. Riflette l'ultima generazione. Le condizioni rilevate durante la preparazione dell'origine vengono invece riportate sul progetto.

Errori

422
Unprocessable Entity Error