---
title: "Traduci un’intera stagione di sottotitoli in una volta sola"
description: "Dieci episodi in cinque lingue sono cinque lavori, non cinquanta: un file ZIP per lingua. Con i comandi e un prompt per un agente."
summary:
  - "Inserisci il file dei sottotitoli di ogni episodio in un unico ZIP e traduci l’archivio una volta per ogni lingua di destinazione: un file di sottotitoli contiene una sola lingua, mentre un archivio può contenere fino a 200 file."
  - "Inserisci i nomi dei personaggi e dei luoghi in un glossario prima del primo avvio, perché se un nome compare in un cue, non c’è contesto che indichi che si tratta di un nome."
  - "Traduci prima una lingua e controlla il risultato, poi ripeti il processo per le altre con la CLI di aiglot oppure affidalo a un agente AI. Solo il passaggio di approvazione consuma crediti."
date: 2026-11-15
language: it
canonical: https://ai-glot.com/it/blog/batch-translate-subtitle-files
source: AI Glot blog
---
**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ù.

*Illustration: Gli episodi restano insieme in un unico archivio, quindi il numero di lavori corrisponde a quello delle lingue.*

## 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 `.vtt` o 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:

```bash
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.

*Illustration: Un nome che compare una sola volta non ha contesto. Il glossario ne stabilisce la traduzione per tutti gli episodi.*

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:

```csv
source,target
The Hollow,The Hollow
Captain Reyes,capitaine Reyes
Marrow Line,ligne Marrow
```

Poi crea un glossario per ogni lingua di destinazione:

```bash
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](https://partnerhelp.netflixstudios.com/hc/en-us/articles/217350977-English-Timed-Text-Style-Guide) 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:

```bash
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:

```bash
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.

*Illustration: Una lingua, dall’inizio alla fine. Tutto ciò che precede l’approvazione è gratuito, così puoi consultare e correggere il piano prima.*

Poi controlla un episodio prima di elaborare gli altri. Tre verifiche bastano a trovare quasi tutto:

1. **Conta i cue.** L’originale e la traduzione di un episodio dovrebbero avere lo stesso numero di cue e lo stesso timecode finale.
2. **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.
3. **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](/it/blog/translate-subtitles-another-language). 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:

```bash
# 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.

*Illustration: Un archivio in inglese, cinque archivi tradotti. I nomi dei file e i timecode restano invariati in ciascuno.*

## 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](/it/blog/translate-youtube-subtitles-multiple-languages) 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](/it/file-formats/zip-translation) 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:

```bash
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](/it/file-formats/srt-translation), oppure [crea un account gratuito](https://app.ai-glot.com/signup) 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.*