---
title: "Traduisez toute une saison de sous-titres en une seule fois"
description: "Dix épisodes en cinq langues, cela fait cinq tâches, pas cinquante : un ZIP par langue. Avec les commandes et un prompt pour l’agent."
summary:
  - "Placez le fichier de sous-titres de chaque épisode dans un seul ZIP, puis traduisez l’archive une fois par langue cible : un fichier de sous-titres contient une langue, et une archive peut contenir jusqu’à 200 fichiers."
  - "Ajoutez les noms des personnages et des lieux à un glossaire avant de lancer la première traduction, car lorsqu’un nom apparaît dans un sous-titre, rien autour ne permet de savoir qu’il s’agit d’un nom propre."
  - "Commencez par une langue et vérifiez le résultat, puis traitez les autres en boucle avec l’interface en ligne de commande aiglot ou confiez cette boucle à un agent IA. Seule l’étape d’approbation consomme des crédits."
date: 2026-11-15
language: fr
canonical: https://ai-glot.com/fr/blog/batch-translate-subtitle-files
source: AI Glot blog
---
**Regroupez tous les épisodes dans un seul ZIP, puis traduisez ce ZIP une fois par langue.** Dix épisodes dans cinq langues, cela fait cinq tâches, pas cinquante. Chaque tâche porte sur toute la saison, applique une instruction et un glossaire à chaque fichier, puis vous renvoie un ZIP avec les mêmes noms de fichiers et les mêmes codes temporels.

Voilà toute la méthode. Le reste de ce guide porte sur ce qui fait sa réussite : comment préparer le dossier, quels noms noter avant de commencer, comment vérifier la première langue et comment traiter les autres à l’aide d’une courte boucle ou d’un prompt destiné à votre agent IA.

## Pourquoi chaque langue constitue une tâche, mais pas chaque épisode

Deux caractéristiques des fichiers de sous-titres déterminent tout le reste.

**Un fichier de sous-titres contient une seule langue.** Un SRT est une liste de répliques, chacune avec un numéro, un code temporel et du texte. Il n’y a pas de deuxième champ pour l’espagnol. Traduire le fichier remplace donc le texte sur place, et une deuxième langue nécessite un deuxième fichier.

**Une archive ZIP peut contenir de nombreux fichiers du même type.** AI Glot la décompresse, traduit chaque fichier selon les mêmes règles, puis la recrée avec les mêmes dossiers et les mêmes noms. Jusqu’à 200 fichiers et 20 MB par archive, ce qui suffit pour de nombreuses saisons : les sous-titres sont en texte brut et un épisode pèse généralement quelques dizaines de kilo-octets.

En combinant les deux, le nombre de tâches correspond au nombre de langues. Le nombre d’épisodes n’a plus d’importance.

*Illustration: Les épisodes sont regroupés dans une seule archive. Il y a donc autant de tâches que de langues.*

## Étape 1 : préparer le dossier de la saison

Exportez les sous-titres de chaque épisode depuis votre logiciel de montage ou votre plateforme, puis regroupez-les dans un dossier. Quelques règles simplifient tout le reste :

- **Un seul format par archive.** Tous les fichiers en `.srt`, ou tous en `.vtt`, ou tous en `.ass`. Une archive contenant plusieurs formats est refusée, car toute la tâche est configurée selon un seul format. Si votre logiciel de montage vous a fourni plusieurs formats, créez une archive par format.
- **Des fichiers uniquement en anglais.** Chaque langue doit partir de l’original, jamais d’une autre traduction. Une traduction faite à partir d’une autre traduction conserve les compromis de la première.
- **Nommez les fichiers pour qu’ils se trient dans le bon ordre.** `s01e01.srt`, `s01e02.srt`. Les noms sont conservés au retour, alors autant bien les choisir dès maintenant.
- **Chaque fichier peut peser jusqu’à 4 MB**, l’archive jusqu’à 20 MB. Pas de fichier ZIP dans l’archive ZIP.

Ensuite, créez une archive ZIP. Sur Mac ou Linux :

```bash
cd ~/Videos/my-show
zip -r season-1.zip season-1 -x '*.DS_Store'
```

De toute façon, nous excluons les fichiers système comme `.DS_Store`, mais inutile de nous les envoyer.

## Étape 2 : notez les noms avant le premier lancement

C’est l’étape que l’on saute, et cela se voit dans l’épisode 7.

**Un nom qui n’apparaît qu’une fois n’a aucun contexte pour indiquer qu’il s’agit d’un nom propre.** Le moteur traduit chaque réplique en tenant compte de vos instructions et des répliques qui l’entourent. C’est largement suffisant pour les dialogues ordinaires. Mais pas pour un lieu appelé « The Hollow », mentionné une seule fois par un personnage dans l’épisode 3. Rien dans cette réplique ne signale qu’il s’agit d’un nom propre. Il peut donc être traduit par un nom commun français dans un épisode et rester en anglais dans un autre.

*Illustration: Un nom qui n’apparaît qu’une fois manque de contexte. Le glossaire en fixe la traduction pour tous les épisodes.*

Un glossaire règle le problème. Il est associé à une seule paire de langues, s’applique à tous les fichiers de l’archive et reste dans votre espace de travail pour la saison suivante. Créez un fichier CSV à deux colonnes :

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

Créez ensuite un glossaire pour chaque langue cible :

```bash
aiglot glossaries create en-fr --from names-fr.csv
aiglot glossaries create en-de --from names-de.csv
```

Deux remarques pratiques. **La paire de langues doit correspondre exactement à celle du forfait** : si le forfait indique `en-US` comme langue source plutôt que `en`, nommez le glossaire `en-US-fr`. Le nombre de glossaires que vous pouvez conserver varie aussi selon le forfait : Free en permet un, Starter trois et Pro un nombre illimité. C’est important pour cinq langues.

## Étape 3 : rédigez deux instructions courtes

Vous pouvez préciser ce que vous souhaitez à deux endroits, et chacun ne s’applique qu’à un type de règle.

**L’instruction du forfait précise quoi traduire.** Elle est lue une seule fois, pour l’ensemble de l’archive. Indiquez ici la langue cible et le périmètre :

```
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’instruction de ligne précise comment rédiger chaque ligne.** Elle s’applique pendant la rédaction de chaque réplique. Elle ne peut donc décrire que ce qui est visible dans une seule réplique :

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

Si vous les intervertissez, aucune erreur ne s’affiche. Une règle de longueur de ligne placée dans l’instruction du forfait n’est pas disponible au moment de rédiger la réplique, donc elle ne fait rien. Indiquez le périmètre dans la première et le style dans la seconde.

La limite de 42 caractères correspond à la [recommandation en anglais](https://partnerhelp.netflixstudios.com/hc/en-us/articles/217350977-English-Timed-Text-Style-Guide) de Netflix pour une ligne. C’est une consigne qui oriente la formulation, et non un contrôle qui rejette les lignes trop longues. Il vaut donc la peine d’ouvrir le premier fichier.

## Étape 4 : lancez une langue et vérifiez le résultat

Commencez par la langue que vous maîtrisez le mieux. La CLI s’utilise en trois commandes :

```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}'
```

Cet appel est gratuit. Il lit l’archive et renvoie le plan : ce qui sera traduit, ce qui restera tel quel, le nombre de mots et le coût. Vérifiez-le. S’il ne vous convient pas, affinez-le gratuitement avec `aiglot batches plan <id> --refine "..."`.

Quand le plan vous convient :

```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` est la seule commande qui dépense des crédits, et elle demande d’abord une confirmation.

*Illustration: Une seule langue, du début à la fin. Tout est gratuit avant l’approbation, vous pouvez donc d’abord consulter et corriger le plan.*

Vérifiez ensuite un épisode avant de lancer les autres. Trois vérifications permettent de repérer presque tous les problèmes :

1. **Comptez les sous-titres.** Le fichier original et la traduction d’un épisode doivent contenir le même nombre de sous-titres et afficher le même dernier code temporel.
2. **Regardez une minute de dialogue rapide.** Chargez la piste sur la vidéo et choisissez une minute où les personnages parlent vite. Les lignes trop longues apparaissent d’abord à cet endroit.
3. **Recherchez deux noms.** Un nom du glossaire et un qui n’y figure pas. Si le deuxième a changé, ajoutez-le au glossaire maintenant, avant de passer aux autres langues.

La liste de vérification complète se trouve dans le guide pour [traduire des sous-titres dans une autre langue](/fr/blog/translate-subtitles-another-language). Chaque problème corrigé ici ne sera à corriger qu’une fois, au lieu de cinq.

## Étape 5 : lancez les autres langues

Une fois qu’une langue est correcte, il suffit de relancer la même commande en changeant le nom de la langue. Cette boucle les traite l’une après l’autre et s’arrête si une tâche échoue :

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

Deux détails de ce script méritent d’être conservés, même dans vos propres scripts.

**`--idempotency-key` permet de relancer la commande sans risque.** Si votre ordinateur se met en veille à mi-parcours, relancez la boucle. Une langue déjà créée renverra la même traduction au lieu d’en créer une deuxième.

**`wait_done` s’arrête aussi en cas de `failed` ou de `cancelled`.** Une boucle qui attend uniquement `completed` reste bloquée indéfiniment en cas d’échec. Celle-ci s’arrête et vous prévient.

L’option `--yes` ignore la confirmation. Utilisez-la donc uniquement après avoir consulté un plan pour la même archive. Si vous voulez consulter chaque plan avant toute dépense, supprimez la ligne `approve`, puis exécutez la commande pour chaque langue après avoir lu le plan.

*Illustration: Une archive en anglais, cinq archives traduites. Les noms de fichiers et les codes temporels restent identiques dans chacune.*

## Ou demandez à votre agent IA de s’en charger

Si vous utilisez Claude Code, Codex ou Cursor dans un terminal, inutile d’écrire la boucle. Décrivez simplement la tâche à l’agent, et il exécute les mêmes commandes :

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

Le point important, c’est l’arrêt avant l’approbation. Tout ce qui précède est gratuit : l’agent peut donc créer, lire et revoir son plan autant de fois que nécessaire, et vous choisissez la dépense en ayant les quatre coûts sous les yeux. Le guide sur les [sous-titres YouTube en plusieurs langues](/fr/blog/translate-youtube-subtitles-multiple-languages) explique plus en détail chaque ligne d’une invite comme celle-ci.

## Combien coûte une saison

Le coût correspond au nombre de mots de la saison multiplié par le nombre de langues.

| | Standard | Lite |
| :--- | :--- | :--- |
| **Crédits** | 1 par mot | 1 pour 3 mots |
| **À qui s’adresse cette option** | Les dialogues que le public suivra de près | Un premier jet ou du contenu que vous comptez de toute façon relire |
| **Forfait requis** | Tous, y compris l’échantillon gratuit | Un forfait payant |

Ainsi, si votre saison compte 30 000 mots, cinq langues représentent 150 000 crédits avec Standard, ou 50 000 avec Lite. Pas besoin de faire le calcul vous-même : avant votre approbation, chaque forfait affiche le nombre de mots mesuré et le coût pour votre propre archive.

Votre première traduction comprend un échantillon gratuit de 5 000 mots, suffisant pour voir à quoi ressemble un épisode dans une autre langue. Le [traducteur ZIP](/fr/file-formats/zip-translation) accepte aussi une archive allant jusqu’à 10 MB, sans compte, à raison de cinq fichiers par jour.

## Remettre les fichiers en place

Les fichiers vous sont renvoyés avec leur nom d’origine dans le ZIP de chaque langue. La plupart des plateformes exigent que la langue figure dans le nom du fichier : ajoutez-la donc avant l’envoi :

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

Importez ensuite chaque fichier comme une nouvelle langue pour l’épisode correspondant. Tous les lecteurs et toutes les plateformes fonctionnent avec une langue à la fois. Cette étape ne peut donc pas être raccourcie, mais avec des fichiers nommés `s01e04.fr.srt`, difficile de se tromper.

## Là où l’intervention humaine reste nécessaire

Pour un court métrage dans une seule langue, demandez à quelqu’un qui la parle. Cette personne fera mieux que n’importe quel processus, et le travail lui prendra un après-midi.

Pour une saison en cinq langues, la gestion des fichiers représente l’essentiel du travail, et ce n’est pas un travail de traduction. Passez la saison dans AI Glot, puis consacrez le temps des experts aux éléments que les spectateurs remarquent : le premier épisode, les blagues et toutes les scènes où les mots font partie de l’histoire. Commencez par une langue avec le [traducteur de sous-titres](/fr/file-formats/srt-translation), ou [créez un compte gratuit](https://app.ai-glot.com/signup) et envoyez toute la saison.

---

*Les limites citées ici ont été vérifiées le 15 novembre 2026 : 200 fichiers et 20 MB par archive, 4 MB par fichier de sous-titres, et une langue cible par tâche. La saison de 30 000 mots sert d’exemple pour le calcul, ce n’est pas un fichier mesuré. Votre forfait indique toujours les chiffres réels.*