# gt: General Translation CLI tool: gt download
URL: https://generaltranslation.com/es/docs/cli/reference/commands/download.mdx
---

title: gt download
description: Descarga las traducciones completadas de General Translation. Referencia de la API para el comando gt download.

---

Descarga las traducciones completadas que se enviaron previamente para su traducción con [`gt enqueue`](/docs/cli/reference/commands/enqueue) o [`gt stage`](/docs/cli/reference/commands/stage), y las guarda en las rutas de salida de tu configuración. Consulta [Administrar traducciones](/docs/cli/guides/managing-translations#split).

*Nota: Solo para uso en producción. Requiere un `GT_API_KEY` y `GT_PROJECT_ID` de producción.*

```bash
npx gt download
```

## Cómo funciona [#how-it-works]

1. Lee `gt.config.json` para determinar la configuración de los archivos.
2. Lee los datos de la versión preparada cuando `stageTranslations` está habilitado; de lo contrario, recopila los archivos y calcula sus hashes para determinar qué descargar.
3. Consulta la API de General Translation para obtener las traducciones completadas.
4. Guarda los archivos de traducción en las rutas de salida de tu configuración.

## Flags [#flags]

`download` acepta el conjunto completo de flags de [`gt translate`](/docs/cli/reference/commands/translate#flags), salvo las flags de escaneo del código fuente (`--src`, `--dictionary`, `--tsconfig`/`--jsconfig`, `--inline`, `--ignore-errors`), que solo se aplican al escanear código fuente. Todas las flags siguientes son válidas; las que afectan a una ejecución solo de descarga son las flags de API, configuración, tiempo de espera, descarga y branch.

| Parámetro                    | Descripción                                                                                     | Tipo       | Opcional | Predeterminado    |
| ---------------------------- | ----------------------------------------------------------------------------------------------- | ---------- | -------- | ----------------- |
| `--api-key <key>`            | API key de producción.                                                                          | `string`   | Sí       | `GT_API_KEY`      |
| `--project-id <id>`          | ID del proyecto.                                                                                | `string`   | Sí       | `GT_PROJECT_ID`   |
| `--version-id <id>`          | ID de la versión que se va a descargar.                                                         | `string`   | Sí       | Hash de contenido |
| `-c, --config <path>`        | Ruta al archivo de configuración.                                                               | `string`   | Sí       | `gt.config.json`  |
| `--default-locale <locale>`  | Configuración regional de origen del proyecto.                                                  | `string`   | Sí       | `en`              |
| `--locales <locales...>`     | Configuraciones regionales de destino adicionales, añadidas a `locales` de la configuración.    | `string[]` | Sí       | —                 |
| `--timeout <seconds>`        | Tiempo de espera en segundos.                                                                   | `number`   | Sí       | `900`             |
| `--dry-run`                  | Analiza y valida sin llamar a la API.                                                           | `boolean`  | Sí       | `false`           |
| `--force`                    | Invalida las traducciones en caché y vuelve a traducir.                                         | `boolean`  | Sí       | `false`           |
| `--force-download`           | Sobrescribe los archivos locales y omite las comprobaciones de `gt-lock.json`.                  | `boolean`  | Sí       | `false`           |
| `--save-local`               | Detecta y guarda las ediciones locales antes de descargar.                                      | `boolean`  | Sí       | `false`           |
| `--publish`                  | Publica las traducciones en la CDN.                                                             | `boolean`  | Sí       | `false`           |
| `--enable-branching`         | Habilita el seguimiento basado en ramas.                                                        | `boolean`  | Sí       | —                 |
| `--branch <branch>`          | Nombre de la rama en lugar de detectarla automáticamente.                                       | `string`   | Sí       | —                 |
| `--disable-branch-detection` | Usa solo la rama especificada, sin detectar relaciones.                                         | `boolean`  | Sí       | `false`           |
| `--remote-name <name>`       | Remoto de Git usado para detectar ramas.                                                        | `string`   | Sí       | `origin`          |
| `--tag [value]`              | Etiqueta la ejecución; se obtiene automáticamente de git cuando no se proporciona ningún valor. | `string`   | Sí       | —                 |
| `-m, --message <message>`    | Mensaje adjunto a la etiqueta de traducción.                                                    | `string`   | Sí       | —                 |

`download` también acepta las flags experimentales enumeradas en [`gt translate`](/docs/cli/reference/commands/translate#experimental) (por ejemplo, `--experimental-clear-locale-dirs`, que borra los directorios de locales antes de escribir nuevas traducciones).

## Ejemplo [#example]

```bash
# Etapa 1: subir los archivos fuente
npx gt upload

# Etapa 2: encolar traducciones
npx gt enqueue

# Etapa 3: descargar las traducciones completadas (este comando)
npx gt download
```

## Otras notas [#notes]

* Cuando `stageTranslations` está habilitado, `download` lee los datos de la versión preparada; de lo contrario, recopila los archivos y calcula sus hashes para determinar qué debe descargar.
* `download` consulta la API hasta que las traducciones estén listas o se alcance `--timeout`, por lo que puede ejecutarse en un trabajo de CI posterior a [`gt enqueue`](/docs/cli/reference/commands/enqueue).