Inserisci tutti gli episodi in un unico ZIP e traduci quello ZIP una volta per lingua. Dieci episodi in cinque lingue sono cinque lavori, non cinquanta. Ogni lavoro comprende l’intera stagione, applica la stessa istruzione e lo stesso glossario a tutti i file e ti restituisce uno ZIP con gli stessi nomi dei file e gli stessi codici temporali.
Questo è tutto il metodo. Il resto della guida spiega cosa fare perché funzioni: come preparare la cartella, quali nomi annotare prima di iniziare, come controllare la prima lingua e come tradurre le altre con un breve ciclo o un prompt per il tuo agente AI.
Perché le lingue richiedono lavori distinti, ma gli episodi no
Due caratteristiche dei file di sottotitoli determinano tutto.
Un file di sottotitoli contiene una sola lingua. Un file SRT è un elenco di cue, ognuno con un numero, un timecode e del testo. Non c’è un secondo campo per lo spagnolo. Traducendolo, quindi, si sostituisce il testo esistente; per una seconda lingua serve un secondo file.
Un file ZIP contiene molti file dello stesso tipo. AI Glot lo estrae, traduce ogni file applicando le stesse regole e lo ricomprime mantenendo cartelle e nomi originali. Puoi caricare fino a 200 file e 20 MB per archivio: abbastanza per diverse stagioni. I sottotitoli sono semplici file di testo e un episodio occupa in genere poche decine di kilobyte.
Mettendo insieme le due cose, il numero di lavori coincide con quello delle lingue. Il numero di episodi non conta più.
- 10 episodi x 5 lingue = 50 caricamenti
- 50 istruzioni da digitare sempre allo stesso modo
- 50 download da rinominare a mano
- Nomi da decidere di nuovo in ogni file
- 5 caricamenti, uno per lingua
- Un'istruzione per lingua
- 5 file ZIP restituiti, nomi dei file invariati
- Un glossario per lingua, valido per tutti gli episodi
Passaggio 1: prepara la cartella della stagione
Esporta i sottotitoli di ogni episodio dal tuo editor o dalla piattaforma, poi inseriscili in un’unica cartella. Bastano poche regole per semplificare tutto il resto:
- Un solo formato per archivio. Tutti
.srt, oppure tutti.vtto tutti.ass. Gli archivi con formati misti vengono rifiutati, perché l’intero lavoro viene pianificato secondo un unico formato. Se il tuo editor ha esportato file in formati diversi, crea un archivio per ciascun formato. - Solo file in inglese. Ogni lingua deve partire dall’originale, mai da un’altra traduzione. Una traduzione fatta a partire da un’altra traduzione si porta dietro i compromessi della prima.
- Assegna ai file nomi che si ordinano correttamente.
s01e01.srt,s01e02.srt. I nomi verranno restituiti invariati, quindi conviene sceglierli subito. - Ogni file può pesare al massimo 4 MB, l’archivio al massimo 20 MB. Non inserire file ZIP all’interno dell’archivio ZIP.
Poi crea un file ZIP. Su Mac o Linux:
cd ~/Videos/my-show
zip -r season-1.zip season-1 -x '*.DS_Store'
Da parte nostra, i file di sistema come .DS_Store vengono comunque esclusi, ma non c’è motivo di inviarli.
Passaggio 2: annota i nomi prima della prima esecuzione
È il passaggio che molti saltano, e nell’episodio 7 se ne vedono le conseguenze.
Se un nome compare una sola volta, non c’è nulla intorno che indichi che si tratta di un nome proprio. Il motore traduce ogni battuta seguendo le tue istruzioni e tenendo conto delle battute circostanti. Per i dialoghi normali è più che sufficiente. Non basta, però, per un luogo chiamato “The Hollow” che un personaggio nomina una sola volta nell’episodio 3. Nella battuta non c’è nulla che indichi che si tratta di un nome proprio, quindi in un episodio può diventare un nome comune francese e in un altro restare in inglese.
21400:18:02,410 --> 00:18:04,950On se retrouve au Creux avant la nuit.On se retrouve à The Hollow avant la nuit.Il glossario risolve il problema. È associato a una sola coppia di lingue, si applica a tutti i file dell’archivio e resta nel tuo spazio di lavoro per la stagione successiva. Crea un CSV a due colonne:
source,target
The Hollow,The Hollow
Captain Reyes,capitaine Reyes
Marrow Line,ligne Marrow
Poi crea un glossario per ogni lingua di destinazione:
aiglot glossaries create en-fr --from names-fr.csv
aiglot glossaries create en-de --from names-de.csv
Due note pratiche. La coppia deve corrispondere esattamente a quella del piano: se il piano indica la lingua di origine come en-US invece di en, chiama il glossario en-US-fr. Inoltre, il numero di glossari che puoi mantenere dipende dal piano: Free ne consente uno, Starter tre e Pro un numero illimitato. Se hai cinque lingue, fa differenza.
Passaggio 3: scrivi due istruzioni brevi
Puoi specificare cosa vuoi in due punti distinti, e ciascuno serve solo per il proprio tipo di regola.
L’istruzione del piano specifica cosa tradurre. Viene letta una volta, considerando l’intero archivio. Qui vanno indicate la lingua di destinazione e l’ambito:
The source language is English. Translate the text of every cue in all
the subtitle files into French. Leave cue numbers and timecodes as they are.
L’istruzione della battuta specifica come scrivere ogni riga. Viene applicata mentre si scrive ciascuna battuta, quindi può descrivere solo ciò che è visibile in una singola battuta:
Use a natural, spoken tone. Keep each line under 42 characters and use at
most two lines per cue. Prefer a shorter phrasing when a line would not fit.
Se le scambi, non viene segnalato alcun errore. Quando si scrive la battuta, la regola sulla lunghezza delle righe non è disponibile nell’istruzione del piano, quindi non ha effetto. Indica l’ambito nella prima e lo stile nella seconda.
Il limite di 42 caratteri è la linea guida in inglese di Netflix per una riga. È una richiesta che influenza la formulazione, non un controllo che rifiuta le righe troppo lunghe, quindi vale la pena aprire il primo file.
Passaggio 4: esegui una lingua e controlla il risultato
Inizia dalla lingua che leggi meglio. Con la CLI bastano tre comandi:
aiglot batches create season-1.zip \
--instruction "The source language is English. Translate the text of every cue in all the subtitle files into French. Leave cue numbers and timecodes as they are." \
--json | jq '{id, plan}'
Questa chiamata è gratuita. Legge l’archivio e restituisce il piano: cosa verrà tradotto, cosa resterà invariato, il conteggio delle parole e il costo. Esaminalo. Se non è corretto, puoi perfezionarlo gratuitamente con aiglot batches plan <id> --refine "...".
Quando il piano è corretto:
aiglot batches approve <id> --quality standard \
--instructions "Use a natural, spoken tone. Keep each line under 42 characters and use at most two lines per cue."
aiglot batches get <id> # repeat until the status is completed
aiglot batches download <id> --output season-1.fr.zip
approve è l’unico comando che utilizza crediti e chiede prima una conferma.
- 1CreaInvia lo ZIP con l’istruzione del pianoGratis
- 2Leggi il pianoFile, parole, costoGratis
- 3ApprovaCon l’istruzione per rigaConsuma crediti
- 4ScaricaUn ZIP, stessi nomiGratis
- 5Controlla un episodioPrima delle altre lingue10 minuti
Poi controlla un episodio prima di elaborare gli altri. Tre verifiche bastano a trovare quasi tutto:
- Conta i cue. L’originale e la traduzione di un episodio dovrebbero avere lo stesso numero di cue e lo stesso timecode finale.
- Guarda un minuto veloce. Carica la traccia sul video e scegli un minuto in cui si parla rapidamente. È lì che le righe troppo lunghe si notano per prime.
- Cerca due nomi. Uno presente nel glossario e uno che non c’è. Se il secondo è stato tradotto in modo incoerente, aggiungilo subito al glossario, prima di passare alle altre lingue.
La checklist completa è nella guida a tradurre i sottotitoli in un’altra lingua. Tutto quello che correggi qui lo sistemi una volta sola, invece di cinque.
Passaggio 5: elabora le altre lingue
Una volta sistemata una lingua, per le altre basta usare lo stesso comando cambiando una parola. Questo ciclo le elabora una dopo l’altra e si interrompe se un’attività non va a buon fine:
# Wait until a translation has finished, or stop if it failed
wait_done() {
while true; do
status=$(aiglot batches get "$1" --json | jq -r '.status')
case "$status" in
completed) return 0 ;;
failed|cancelled) echo "$1 ended as $status" >&2; return 1 ;;
esac
sleep 10
done
}
for pair in de:German es:Spanish it:Italian pt:Portuguese; do
code=${pair%%:*}
lang=${pair#*:}
id=$(aiglot batches create season-1.zip \
--idempotency-key "season-1-${code}" \
--instruction "The source language is English. Translate the text of every cue in all the subtitle files into ${lang}. Leave cue numbers and timecodes as they are." \
--json | jq -r '.id')
aiglot batches approve "$id" --quality standard --yes \
--instructions "Use a natural, spoken tone. Keep each line under 42 characters and use at most two lines per cue."
wait_done "$id" && aiglot batches download "$id" --output "season-1.${code}.zip"
done
Vale la pena mantenere due dettagli, anche nei tuoi script.
--idempotency-key rende sicura una nuova esecuzione. Se il portatile va in sospensione a metà, esegui di nuovo il ciclo. Una lingua già creata restituisce la stessa traduzione, anziché crearne una seconda.
wait_done si interrompe anche con failed e cancelled. Un ciclo che attende solo completed resta in attesa per sempre se un’attività non va a buon fine. Questo invece si interrompe e te lo segnala.
--yes salta la conferma, quindi usalo solo dopo aver letto un piano relativo allo stesso archivio. Se vuoi vedere ogni piano prima che venga speso qualcosa, rimuovi la riga approve ed esegui il comando per ciascuna lingua dopo averlo letto.
Oppure chiedi al tuo agente AI di farlo
Se usi Claude Code, Codex o Cursor da terminale, non devi scrivere il ciclo. Descrivi all’agente cosa deve fare con parole semplici e lui eseguirà gli stessi comandi:
My English subtitles for season 1 are in ~/Videos/my-show/season-1.zip,
one SRT per episode.
Using the aiglot CLI, translate the archive into German, Spanish, Italian
and Portuguese: one batch per language, because a subtitle file holds one
language. Read `aiglot batches create --help` first so you use the real
flags. Say "The source language is English" in every instruction.
Line instruction at approval: natural spoken tone, under 42 characters
per line, two lines per cue at most.
Show me the four plans with their word counts and costs, then stop and
wait for my go before approving anything. After that, download each
result as season-1.<code>.zip and tell me if any job failed.
La riga importante è quella che si ferma prima dell’approvazione. Tutto ciò che viene prima è gratuito, quindi l’agente può creare, leggere e rielaborare il piano tutte le volte che serve, mentre tu decidi quanto spendere con quattro costi davanti. La guida ai sottotitoli YouTube in più lingue spiega più nel dettaglio ogni riga di un prompt come questo.
Quanto costa una stagione
Il costo si calcola moltiplicando il numero di parole della stagione per il numero di lingue.
| Standard | Lite | |
|---|---|---|
| Crediti | 1 per parola | 1 ogni 3 parole |
| A chi è rivolto | Dialoghi che il pubblico seguirà con attenzione | Una prima versione o contenuti che rivedrai comunque |
| Piano richiesto | Qualsiasi, anche il campione gratuito | Un piano a pagamento |
Quindi, se la tua stagione contiene 30.000 parole, per cinque lingue servono 150.000 crediti con Standard oppure 50.000 con Lite. Non devi fare i calcoli da solo: prima che approvi, ogni piano mostra il conteggio delle parole e il costo calcolati sul tuo archivio.
La tua prima traduzione include un campione gratuito di 5.000 parole, sufficiente per vedere come appare un episodio in un’altra lingua. Il traduttore ZIP accetta anche un archivio fino a 10 MB senza account, con un limite di cinque file al giorno.
Reinserire i file
I file vengono restituiti con i nomi originali all’interno dello ZIP di ciascuna lingua. La maggior parte delle piattaforme richiede che la lingua sia indicata nel nome del file, quindi aggiungila prima del caricamento:
mkdir fr && unzip -q season-1.fr.zip -d fr
cd fr/season-1
for f in *.srt; do mv "$f" "${f%.srt}.fr.srt"; done
Poi carica ogni file come nuova lingua nell’episodio corrispondente. Ogni lettore e piattaforma gestisce una lingua alla volta, quindi questo passaggio non si accorcia, ma con file chiamati s01e04.fr.srt è almeno difficile sbagliare.
Quando serve ancora una persona
Per un cortometraggio in una sola lingua, chiedi a qualcuno che la parla. Farà un lavoro migliore di qualsiasi processo e gli basterà un pomeriggio.
Per una stagione in cinque lingue, la maggior parte del lavoro riguarda la gestione dei file, non la traduzione. Elabora la stagione con AI Glot, poi dedica il tempo degli esperti ai punti che il pubblico nota: il primo episodio, le battute e tutte le scene in cui le parole sono la storia. Inizia con una lingua usando il traduttore di sottotitoli, oppure crea un account gratuito e invia l’intera stagione.
I limiti riportati qui sono stati verificati il 15 novembre 2026: 200 file e 20 MB per archivio, 4 MB per file di sottotitoli e una lingua di destinazione per operazione. La stagione di 30.000 parole è un esempio per i calcoli, non un file misurato. Il tuo piano mostra sempre i dati effettivi.
