Crea progetto di doppiaggio
Crea un progetto di doppiaggio da un file caricato (file) o da un URL di origine (source_url).
Restituisce non appena esiste il record del progetto, prima che l’origine sia stata recuperata: il progetto inizia in stato queued e passa a ready una volta trascritta l’origine. Aggiungi un target di lingua per ogni lingua desiderata oppure passa target_language per mettere in coda qui il primo.
La creazione di un progetto comporta un addebito minimo per una lingua: al momento della creazione del progetto ti viene addebitato il doppiaggio di almeno una lingua, prima che esista qualsiasi output. Questo addebito prepagato copre il primo target di lingua — il primo target aggiunto o quello messo in coda tramite target_language lo utilizza — e ogni lingua aggiuntiva viene addebitata separatamente.
La preparazione può richiedere alcuni minuti per un’origine lunga, quindi ti consigliamo di passare webhook_ids per ricevere una notifica quando il progetto passa a ready o failed, anziché eseguire il polling.
Header
Richiesta
Il file multimediale sorgente da doppiare: un file audio o video di massimo 3 GiB. Fornisci questo oppure source_url, non entrambi.
URL HTTP(S) pubblico da cui il media sorgente viene recuperato lato server, soggetto agli stessi limiti di dimensioni e formato di un caricamento. Fornisci questo o file, non entrambi.
Stringa facoltativa in formato libero, di massimo 500 caratteri, per identificare il progetto nel tuo sistema. Viene archiviata e restituita letteralmente; non influisce sul doppiaggio.
Tag lingua BCP-47 del media di origine; deve corrispondere a una lingua supportata dal modello di trascrizione. Gli eventuali sottotag di regione o script vengono ignorati, poiché la trascrizione è specifica per lingua. Ometti per il rilevamento automatico.
Modello di doppiaggio (dubbing_v1 o dubbing_v2) usato per doppiare ogni destinazione linguistica di questo progetto. Il valore predefinito è dubbing_v2. Viene fissato al momento della creazione: la sorgente è preparata per questo modello, quindi né il progetto né una singola destinazione possono modificarlo in seguito.
Termini chiave verso cui orientare la trascrizione e la traduzione, ad esempio nomi di prodotti o marchi. Massimo 1.000 termini; ogni termine può avere al massimo 50 caratteri e 5 parole; i caratteri <>{}[]\ non sono consentiti. Gli spazi iniziali e finali vengono rimossi dai termini e i duplicati vengono eliminati. Ripeti il campo una volta per termine oppure passa un unico array JSON.
ID dei webhook del workspace da notificare man mano che il progetto avanza: l'alternativa al polling che consigliamo. Ognuno riceve un evento dubbing_project_ready o dubbing_project_failed per il progetto e un evento dubbing_language_completed o dubbing_language_failed per ogni lingua associata; dubbing_language_completed contiene gli URL per scaricare l'output. Massimo 3 ID, ciascuno già configurato nel tuo workspace: consulta Webhooks per scoprire come crearne uno e verificarne la firma. Ripeti il campo una volta per ID oppure passa un singolo array JSON o una stringa separata da virgole. La consegna avviene secondo il criterio best-effort e può ripetersi, quindi consigliamo di gestire gli eventi in modo idempotente.
Scorciatoia facoltativa: crea anche una lingua di destinazione in questa lingua BCP-47, messa in coda per l'avvio quando il progetto è pronto. Equivale a creare il progetto e poi una lingua di destinazione. Deve essere una delle lingue supportate dal modello di doppiaggio e un tag con regione deve corrispondere a uno dei dialetti supportati. Questa è la prima lingua di destinazione, quindi utilizza l'addebito minimo del progetto anziché aggiungersi a esso. Il suo ID viene restituito in language_ids.
Solo Enterprise. Trascrizione JSON facoltativa da usare al posto della trascrizione della sorgente: un documento {"segments": [...]} con al massimo 20.000 segmenti e 4 MiB. Consulta Usa la tua trascrizione per i campi dei segmenti e i relativi vincoli. source_language è obbligatorio ogni volta che viene fornita una trascrizione. Se un segmento contiene una translation, target_language è obbligatorio e ogni segmento deve contenerne una; tali traduzioni inizializzano la destinazione creata tramite target_language, che quindi salta la traduzione automatica.
Risposta
Stato del ciclo di vita del progetto: queued prima che la sorgente venga acquisita, preparing durante la trascrizione, ready quando la trascrizione è completata e le lingue di destinazione possono iniziare, oppure failed. Un progetto non viene mai riportato come processing: questo valore appartiene alle lingue di destinazione.
Quando è stato creato il progetto.
Quando il progetto è stato aggiornato l'ultima volta.
La stringa in formato libero fornita come reference durante la creazione del progetto, oppure null se non ne hai fornita alcuna.
Tag lingua BCP-47 del media di origine (null se rilevato automaticamente).
Modello di doppiaggio usato per doppiare ogni destinazione linguistica di questo progetto. Viene fissato al momento della creazione e non è selezionabile per lingua.
Metadati del contenuto multimediale sorgente, popolati dopo che la sorgente è stata recuperata e decodificata, poco dopo la creazione e prima che il progetto sia ready; fino a quel momento, null.
Identificatori delle lingue di destinazione in questo progetto. Vengono popolati quando si recupera un singolo progetto e alla creazione quando target_language ne crea una. Sono sempre vuoti nelle risposte di elenco: elenca invece le lingue di destinazione del progetto.
ID dei webhook del workspace notificati quando questo progetto e le relative lingue raggiungono lo stato ready, completed o failed.
Motivo per cui il progetto non è riuscito; null a meno che status non sia failed. È null anche per i pochi progetti non riusciti prima dell'introduzione della segnalazione degli errori.
Condizioni non fatali rilevate durante la preparazione dell'origine; è vuoto se non ce ne sono. Riflette l'ultima preparazione. Le condizioni rilevate durante il doppiaggio di una lingua specifica vengono invece riportate per quella lingua.