Skip to main content
Ottieni lo stato della traduzione

Ottieni lo stato della traduzione

Recupera lo stato attuale di un progetto di traduzione. Utilizza questo endpoint per verificare il progresso e ottenere l’URL del video tradotto una volta completata l’elaborazione.

Richiesta

Intestazioni

string
obbligatorio
La tua chiave API VoiceCheap. Ottienine una da app.voicecheap.ai/page-api.

Parametri del percorso

string
obbligatorio
L’identificatore univoco del progetto di traduzione restituito dall’endpoint Start Translation.

Risposta

La struttura della risposta varia in base allo stato della traduzione.

Campi comuni

string
obbligatorio
L’identificatore univoco del progetto
string
obbligatorio
Il nome del progetto
string
obbligatorio
URL del file video/audio originale caricato
string
obbligatorio
La lingua originale rilevata o specificata
string
obbligatorio
La lingua di destinazione per la traduzione
number
obbligatorio
Durata del contenuto in secondi
number
obbligatorio
Timestamp Unix di creazione del progetto
string
obbligatorio
Flusso di lavoro API che ha creato il progetto: translation o transcription.
string
obbligatorio
Stato della trascrizione sorgente: processing, success o failed. Questo segnale è indipendente dal completamento del doppiaggio.
object
obbligatorio
Trascrizioni normalizzate disponibili.
string
Identificatore del lavoro di traduzione per la versione tradotta attualmente riportata.
string
Identificatore della versione tradotta per la versione tradotta attualmente riportata.
string
Fase attuale del progetto. Durante la creazione o la trascrizione, riflette la fase di creazione attiva. Esempi includono downloading_content, content_validation e transcription_processing. Una volta avviato il doppiaggio, può passare a una fase di doppiaggio attiva come smart_sync o audio_assembling. status: processing non si abbina a actualProgressStep: done.
number
Percentuale di progresso approssimativa per la creazione/trascrizione del progetto (0-100)
string
Fase di doppiaggio attuale per la lingua di destinazione (es. smart_sync, audio_enhancement, video_upload)
number
Percentuale di progresso approssimativa per il doppiaggio (0-100)
string
obbligatorio
Stato attuale della traduzione: processing, success o failed

Campi Lip Sync

Quando è stata richiesta la sincronizzazione labiale, la risposta include un oggetto lipSync aggiuntivo:
object
Stato della sincronizzazione labiale e dettagli dell’output (presente solo quando è stata richiesta la sincronizzazione labiale)
Quando viene richiesta la sincronizzazione labiale, la traduzione rimane in processing finché lipSync.status non è COMPLETED. Se la sincronizzazione labiale fallisce, lo stato diventa failed e error.code è LIPSYNC_FAILED. Quando la sincronizzazione labiale ha successo, leggi l’asset sincronizzato labialmente da lipSync.videoUrl; translatedVideoUrl è il video tradotto in output prima della sovrapposizione della sincronizzazione labiale.
Usa GET /v1/projects/{projectId} quando hai bisogno della cronologia completa delle versioni tradotte o della cronologia completa della sincronizzazione labiale.

Campi della risposta di successo

Per i flussi di lavoro di traduzione, i seguenti campi sono inclusi quando status è success. Un flusso di lavoro di sola trascrizione raggiunge success senza campi multimediali tradotti.
string
URL per scaricare il file video tradotto
string
URL per scaricare separatamente il file audio tradotto

Campi della risposta di errore

Quando status è failed, viene incluso il seguente campo aggiuntivo:
object
Dettagli dell’errore

Esempi

Esempi di risposta

Stato di elaborazione

Stato di elaborazione (Lip Sync Richiesto)

Stato di successo

Stato di successo (Lip Sync Completato)

Stato di fallimento

Best practice per il polling

Intervallo di polling consigliato: 10-30 secondiIl tempo di traduzione varia in base alla lunghezza e alla complessità del video. Per un tipico video di 2 minuti, prevedere 2-5 minuti di tempo di elaborazione.
Limite di frequenza: 30 richieste al minutoEvita di eseguire il polling più frequentemente di una volta ogni 2 secondi per rimanere entro i limiti di frequenza.

Errori