# gt: General Translation CLI tool: Télécharger
URL: https://generaltranslation.com/fr/docs/cli/download.mdx
---
title: Télécharger
description: Comment télécharger des traductions précédemment ajoutées à la file d’attente ou mises en staging
---

## Utilisation

```bash
npx gt download
```

<Callout type="info">
  **Remarque :** Cette commande nécessite une clé API de production ! Vous pouvez en obtenir une sur la
  [plateforme](https://generaltranslation.com/dashboard).
</Callout>


## Vue d’ensemble

La commande `gt download` télécharge les traductions finalisées qui ont été précédemment envoyées à la traduction via [`gt enqueue`](/docs/cli/enqueue) ou [`gt stage`](/docs/cli/stage).

Le flux de travail typique est le suivant :

1. [`gt upload`](/docs/cli/upload) — envoyer les fichiers source vers la plateforme General Translation
2. [`gt enqueue`](/docs/cli/enqueue) — mettre en file d’attente les fichiers envoyés pour traduction
3. **`gt download`** — télécharger les traductions finalisées

Cette séparation est utile dans les pipelines CI/CD, où chaque étape s’exécute à un stade ou dans un job différent.

<Callout type="warn">
  **Pour une utilisation en production uniquement !**

  Cette commande est destinée aux builds de production et **ne doit pas être utilisée en développement**.
  N’oubliez pas d’indiquer votre clé API de production (`GT_API_KEY`) et l’ID du projet (`GT_PROJECT_ID`) dans vos variables d’environnement.
</Callout>

## Fonctionnement

1. Lit votre `gt.config.json` pour déterminer la configuration des fichiers
2. Si `stageTranslations` est activé, lit les données de la version mise en staging ; sinon, collecte les fichiers et calcule leur hash pour déterminer ce qui doit être téléchargé
3. Interroge l’API General Translation jusqu’à ce que les traductions soient prêtes
4. Télécharge et enregistre les fichiers de traduction dans les chemins de sortie spécifiés dans votre configuration

## Options

La commande `download` accepte les mêmes options que [`translate`](/docs/cli/translate#flags).

| Paramètre         | Description                                                | Type     | Facultatif | Par défaut         |
| ----------------- | ---------------------------------------------------------- | -------- | ---------- | ------------------ |
| `--api-key`       | Spécifie une clé API de production                         | `string` | `true`     |                    |
| `--project-id`    | Spécifie l’ID du projet                                    | `string` | `true`     |                    |
| `--version-id`    | Spécifie un ID de version (par défaut, un hash du contenu) | `string` | `true`     |                    |
| `--config <path>` | Spécifie le chemin vers le fichier de configuration GT     | `string` | `true`     | `"gt.config.json"` |

| `--timeout`                     | Délai d’expiration de la requête, en secondes                                               | `number`   | `true`     | `900`              |
| `--new, --locales <locales>`    | Paramètres régionaux dans lesquels traduire votre projet                                    | `[string]` | `true`     |                    |
| `--default-locale <locale>`     | Le paramètre régional source du projet                                                      | `string`   | `true`     | `en`               |
| `--dry-run`                     | Exécute la commande à blanc                                                                 | `flag`     | `true`     | `false`            |
| `--force`                       | Force le téléchargement de toutes les traductions en écrasant les modifications locales     | `flag`     | `true`     | `false`            |
| `--force-download`              | Force le téléchargement de toutes les traductions en écrasant les modifications locales     | `flag`     | `true`     | `false`            |

## Exemple : pipeline CI scindé

```bash
# Étape 1 : upload des fichiers source
npx gt upload

# Étape 2 : mise en file d'attente des traductions
npx gt enqueue

# Étape 3 : téléchargement une fois prêt
npx gt download
```