Skip to main content
Avvia traduzione

Avvia traduzione

Crea un nuovo progetto di traduzione caricando un file video o audio. Il processo di traduzione viene eseguito in modo asincrono in background. Utilizza l’endpoint di stato per monitorare l’avanzamento e recuperare i risultati. Utilizza Ottieni dettagli del progetto quando hai bisogno della cronologia delle versioni tradotte o della cronologia della sincronizzazione labiale.

Limite di concorrenza

La creazione dei progetti, la traduzione e il doppiaggio verificano tutti il limite di traduzioni attive dell’account (al massimo 10, eventualmente meno). Solo le traduzioni o i doppiaggi in corso occupano posti; i progetti di sola trascrizione no. Al raggiungimento del limite, l’API restituisce CONCURRENT_TRANSLATION_LIMIT_REACHED (HTTP 429). Il limite applicato è indicato in details.limit.

Richiesta

Questo endpoint accetta multipart/form-data con un caricamento di file.

Intestazioni

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

Parametri del corpo

file
obbligatorio
Il file video o audio da tradurre.Formati video supportati: video/mp4, video/quicktime, video/x-matroska, video/webm, video/mpegFormati audio supportati: audio/mpeg, audio/wav, audio/mp4, audio/x-m4a, audio/flac, audio/ogg, audio/aac, audio/webmDimensione massima del file per piano: Beginner 5 GB, Starter 10 GB, Creator 20 GB, Pro 30 GB, Scale 40 GB e Enterprise 60 GB.
string
obbligatorio
La lingua in cui tradurre il contenuto. Deve essere in minuscolo.Valori consentiti (70+): afrikaans, albanian, amharic, arabic, armenian, assamese, azerbaijani, basque, belarusian, bengali, bosnian, bulgarian, catalan, croatian, czech, danish, dutch, english, british english, estonian, finnish, french, french canadian, galician, german, greek, gujarati, hebrew, hindi, hungarian, icelandic, indonesian, irish, italian, japanese, kannada, kazakh, khmer, korean, lao, latvian, lithuanian, macedonian, malay, malayalam, mandarin, marathi, mongolian, nepali, norwegian, persian, polish, portuguese, brazilian portuguese, pt_brazil, punjabi, romanian, russian, serbian, slovak, slovenian, spanish, swahili, swedish, tagalog, tamil, telugu, thai, turkish, ukrainian, urdu, vietnamese, welsh, yoruba, zulu
string
La lingua di origine del contenuto utilizzando i codici lingua ISO (es. en, es, fr, de, ja, zh).
Fortemente consigliato: lasciare vuoto per il rilevamento automatico.Fornisci questo parametro solo se sei sicuro al 100% che il codice lingua sia corretto e nel formato ISO valido. Codici lingua errati causeranno errori di trascrizione. Il nostro rilevamento automatico supporta oltre 80 lingue ed è altamente accurato.
Predefinito: auto-detect
string
Un nome personalizzato per il progetto. Utile per identificare i progetti nella tua dashboard.Predefinito: Se non fornito, verrà utilizzato l’ID progetto.
string
Un endpoint https che riceve gli eventi webhook per questo progetto, sovrascrivendo l’endpoint configurato sul tuo account.Predefinito: L’endpoint webhook dell’account, quando configurato.
string
auto-detect o un numero intero da 1 a 32. Un numero noto di parlanti può migliorare la diarizzazione.Predefinito: auto-detect
string
Un array di stringhe JSON di nomi, marchi, acronimi o termini specialistici specifici della richiesta. Questi termini vengono uniti al glossario salvato dell’account o del team.
boolean
Rimuovi le comuni parole riempitive dalla trascrizione di origine prima della traduzione.Predefinito: true
string
Una trascrizione SRT in lingua originale esistente. originalLanguage deve essere esplicito quando viene fornito questo campo.
string
L’SRT finale nella lingua di destinazione, scritto da te. Se presente, VoiceCheap salta il motore di traduzione e genera solo le voci e il mix a partire da questo testo. Vedi la modalità solo doppiaggio per le regole di allineamento. Massimo 1.000.000 di caratteri.
boolean
Indica se preservare l’audio di sottofondo nell’output.Se abilitato, mantiene la musica di sottofondo, l’ambiente, le risate, gli applausi e i suoni della folla rimuovendo solo la voce originale (separazione delle tracce). Disattiva se la tua sorgente non ha audio di sottofondo.Predefinito: true
boolean
Mantieni la voce originale a basso volume sotto la voce tradotta.Predefinito: false
number
Volume della voce originale da 1 a 70 quando keepOriginalVoice è abilitato.Predefinito: 30
string
Modalità di isolamento vocale quando keepBackgroundMusic è abilitato. Controlla la qualità e le caratteristiche della separazione vocale.
La nostra elaborazione vocale predefinita, progettata per una qualità audio professionale:
  • Rimuove echi e riverberi
  • Pulisce le imperfezioni tecniche
  • Produce una voce chiara e nitida
Consigliato per: La maggior parte dei progetti in cui la qualità audio è fondamentale. Ideale per tutorial, contenuti educativi, video di marketing e qualsiasi contenuto che richieda una chiarezza vocale ottimale.
Preserva le caratteristiche naturali dell’ambiente di registrazione:
  • Mantiene un suono più vicino alla registrazione originale
  • Preserva le caratteristiche ambientali
Consigliato per: Contenuti in cui l’autenticità dell’ambiente è importante, come vlog all’aperto, documentari o contenuti in cui l’atmosfera sonora è parte integrante dell’esperienza.
Questa opzione potrebbe creare artefatti o effetti imprevisti in alcuni casi a causa della conservazione degli elementi di sottofondo.
Valori consentiti: studio, realisticPredefinito: studio
boolean
Indica se generare sottotitoli per il video tradotto.Se abilitato, aggiunge sottotitoli chiari in bianco e nero. Usa subtitlesSource per scegliere il testo originale (lingua di origine) o tradotto (lingua di destinazione). I sottotitoli vengono sincronizzati automaticamente per facilitarne la lettura.Predefinito: false
string
Scegli la fonte del testo dei sottotitoli quando subtitles è abilitato.Valori consentiti: translated, originalPredefinito: translatedNota: Se viene selezionato original ma la trascrizione originale non è disponibile, i sottotitoli ripiegheranno su translated.
string
Avvia l’elaborazione della sincronizzazione labiale al termine della traduzione.
  • standard = Lip Sync
  • pro = Lip Sync Pro
  • studio = Lip Sync Studio
Le modalità premium applicano i requisiti standard di piano, durata e crediti.Predefinito: omettere il campo per saltare la sincronizzazione labiale.
boolean
Abilita il rilevamento del parlante attivo per l’esecuzione della sincronizzazione labiale richiesta.Predefinito: false
boolean
Selettore di sincronizzazione labiale legacy mantenuto per compatibilità con le versioni precedenti.
  • false = Sincronizzazione labiale standard (4 minuti di crediti per 1 minuto di video)
  • true = Lip Sync Pro (9 minuti di crediti per 1 minuto di video)
Lip Sync Pro è disponibile a partire dal piano Creator.
Durata massima: 180 minuti per video.Latenza: L’elaborazione della sincronizzazione labiale aggiunge solitamente 2x-4x la durata del video originale.
Le email di completamento e fallimento della sincronizzazione labiale non vengono inviate per le richieste attivate tramite API. Utilizza l’endpoint di stato per monitorare l’avanzamento.
Predefinito: non abilitato (omettere il campo per saltare la sincronizzazione labiale)Form-data: Invia i valori booleani come stringhe true o false (es. -F "lipsyncPro=false").
Non combinare lipsyncPro con un lipSyncMode in conflitto.
string
Strategia vocale: cloning o custom.Predefinito: cloning
string
Obbligatorio quando voiceMode è custom. Usa un ID di dubbing_voices_list: una voce del catalogo o una voce personalizzata salvata dall’account autenticato. La fatturazione del team non concede accesso alle voci salvate degli altri membri.
object
Ottimizza i parametri di clonazione vocale per un controllo avanzato sulla voce generata. Passa come stringa JSON quando utilizzi form-data. Tutti i valori devono essere compresi tra 0 e 1 (con incrementi di 0,01). Un valore speakerBoost inviato da integrazioni precedenti è ancora accettato, ma non ha più alcun effetto.
Queste impostazioni si applicano solo quando voiceMode è cloning.
Valori predefiniti (bilanciati):
string
Un array JSON di intervalli di tempo sorgente che dovrebbero rimanere nella lingua originale.
I salti temporali richiedono un input video e keepBackgroundMusic=true. Non possono essere combinati con keepOriginalVoice e non possono sovrapporsi ai segmenti di trascrizione.

Modalità solo doppiaggio (usa la tua traduzione)

Invia translatedSrt quando hai già la traduzione e ti serve VoiceCheap solo per generare le voci e mixare l’output. In questa modalità:
  • Nessuna traduzione IA e nessuna riformulazione SmartSync. Ogni cue viene letto così com’è. Anche le regole del glossario salvate e le istruzioni di traduzione personalizzate non si applicano, perché vengono eseguite solo dal motore di traduzione.
  • Il tempo viene dalla fonte. Ogni segmento conserva inizio, fine e parlante della trascrizione di origine; i timecode del tuo SRT servono solo ad abbinare i cue ai segmenti. Il parlato generato viene allungato o compresso per entrare nella finestra del segmento, senza riformularlo.
  • Gli stessi crediti di una traduzione. L’esecuzione viene addebitata esattamente come una traduzione standard dello stesso media.
  • Le opzioni di voce, sottofondo, sottotitoli e sincronizzazione labiale restano invariate. voiceMode, keepBackgroundMusic, subtitles, lipSyncMode e le altre opzioni di doppiaggio si comportano come documentato sopra.
Il message della risposta conferma la modalità e la versione tradotta riporta dubbingMode: "dub-only" in Ottieni dettagli del progetto.

Regole di allineamento

I problemi di allineamento in modalità timestamps si conoscono solo dopo la trascrizione e vengono segnalati in modo asincrono. L’endpoint di stato restituisce HTTP 200 con status: "failed" e un error contenente code e message; il webhook project.translation.failed contiene lo stesso codice e messaggio. TRANSLATED_SRT_UNMATCHED_CUES indica nel messaggio i numeri dei cue senza corrispondenza, mentre TRANSLATED_SRT_MISSING_SEGMENTS indica gli indici dei segmenti senza cue. Queste risposte non includono un campo details strutturato. Per un allineamento deterministico, invia sourceSrt con translatedSrt oppure crea prima il progetto con Crea progetto, esporta la trascrizione, traducila cue per cue e chiama Doppiaggio del progetto.

Controllare il ritmo

Le frasi lunghe devono essere accelerate per entrare nel loro segmento. Esporta la trascrizione tradotta con Esporta trascrizione del progetto: ogni segmento tradotto include finalSpeedFactor, il rapporto tra il parlato generato e la finestra del segmento prima dell’adattamento finale del tempo. Accorcia i cue che restano sopra circa 1.3, poi esegui di nuovo il doppiaggio con l’SRT rivisto.
translatedSrt è accettato anche dall’endpoint JSON Doppiaggio del progetto, che doppia un progetto già trascritto senza caricare di nuovo il media.

Risposta

boolean
obbligatorio
Sempre true per le richieste riuscite
string
obbligatorio
Un messaggio leggibile dall’utente che descrive il risultato
string
obbligatorio
L’identificativo univoco per il progetto di traduzione creato. Usa questo ID per controllare lo stato.
number
obbligatorio
Stima approssimativa dell’elaborazione in minuti. La stima attuale è di cinque minuti di elaborazione per ogni minuto di file multimediale sorgente avviato.

Esempi

Le regole del glossario salvate e le istruzioni di traduzione personalizzate dell’account o del team effettivo vengono applicate automaticamente.

Esempio di risposta

Errori