Introduzione
Video Translator doppia in un’altra lingua un clip con persone che parlano. Invia il girato in video_url e scegli target_language: lo strumento trascrive il parlato, lo traduce, lo registra di nuovo in sincronia con le battute originali e restituisce la stessa immagine con il nuovo audio. Attiva clone_voice e ogni parlante mantiene una voce modellata sulla propria.
Caratteristiche principali
I parlanti restano riconoscibili
Con clone_voice attivo, il doppiaggio viene pronunciato con una voce costruita su quella di ciascun parlante: nel nostro test a due persone, la donna e l’uomo sono tornati in spagnolo con il proprio timbro, e ogni battuta è iniziata dove era iniziata quella originale.
Tieni la colonna sonora o eliminala
keep_background_audio decide cosa resta sotto il doppiaggio. Lasciato attivo, l’ambiente della cantina e il tono della stanza restano esattamente dove erano. Disattivato, il clip restituito contiene solo le voci tradotte con silenzio vero tra una battuta e l’altra, pronto per il tuo mix.
I tuoi nomi restano i tuoi
Elenca i termini in glossary come coppie {term, translation} e verranno sempre tradotti come vuoi tu. Nel nostro test una frase inserita nel glossario è stata usata alla lettera in entrambe le battute in cui compariva.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
video_url | Sì | Il clip da tradurre, da 1 secondo a 10 minuti. L’immagine torna invariata. almeno 1 caratteri |
target_language | No | La lingua in cui doppiare, una tra 28. Predefinita: inglese. |
source_language | No | La lingua parlata nel clip. Predefinita: auto, che la rileva. |
clone_voice | No | Disattivato per impostazione predefinita. Attivo: ogni parlante viene ridoppiato con una voce modellata sulla propria. Predefinito: |
keep_background_audio | No | Attivo per impostazione predefinita: musica ed effetti sonori restano sotto il doppiaggio. Disattivato: vengono restituite solo le voci tradotte, con silenzio tra le battute. Predefinito: |
speaker_count | No | Quante persone parlano nel clip, da 1 a 4. Omettilo per lasciare che lo strumento le conti. |
glossary | No | Nomi, marchi e frasi con una traduzione fissa, come coppie termine / traduzione, fino a 100. al massimo 100 elementi |
Prezzi
$0.005 / secondo generato
Addebitato in minuti interi del clip di partenza, quindi un clip di 70 secondi costa quanto 2 minuti. Il clip deve durare da 1 secondo a 10 minuti; la stima prima dell’invio usa la durata reale di un clip caricato, oppure il massimo di 10 minuti per un URL video, e l’eventuale differenza viene rilasciata alla chiusura del task. Opzioni come le voci clonate o la rimozione dello sfondo non cambiano il prezzo.
Casi d’uso
Localizzare i video brevi
Pubblica lo stesso clip per più mercati linguistici senza ingaggiare un doppiatore per ognuno. I clip sotto il minuto costano un minuto.
Doppiare i personaggi dei modelli video
I personaggi generati che parlano inglese possono essere doppiati nella lingua del tuo pubblico, mantenendo la voce del personaggio.
Consigli avanzati
Imposta la lingua parlata quando c’è musica
Il rilevamento automatico è affidabile sul parlato pulito. Su un clip con una chitarra sotto una battuta in francese sussurrata si è arreso e il task è fallito (rimborsato); lo stesso clip con source_language impostato su francese è andato a buon fine. Se un task fallisce con un messaggio sull’elaborazione del video, imposta source_language e invia di nuovo la richiesta.
Indica quante persone parlano
speaker_count è facoltativo, ma impostarlo su un dialogo a due persone fa sì che ogni battuta resti con la voce giusta.
Pensa all’immagine
Viene sostituito solo l’audio. Per i primi piani in cui conta la bocca, passa il clip doppiato allo strumento Lip Sync.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-translator-v1/video-translate",
"input": {
"source_language": "auto",
"target_language": "en",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
