# gt: General Translation CLI tool: Descargar
URL: https://generaltranslation.com/es/docs/cli/download.mdx
---
title: Descargar
description: Cómo descargar traducciones que se habían puesto en cola o preparado previamente
---

## Uso

```bash
npx gt download
```

<Callout type="info">
  **Nota:** Este comando requiere una clave de API de producción. Obtén una en la
  [plataforma](https://generaltranslation.com/dashboard).
</Callout>


## Resumen

El comando `gt download` descarga las traducciones finalizadas que se enviaron previamente para su traducción mediante [`gt enqueue`](/docs/cli/enqueue) o [`gt stage`](/docs/cli/stage).

El flujo habitual es:

1. [`gt upload`](/docs/cli/upload) — cargar los archivos fuente a la plataforma de General Translation
2. [`gt enqueue`](/docs/cli/enqueue) — poner en cola los archivos cargados para su traducción
3. **`gt download`** — descargar las traducciones finalizadas

Esta separación resulta útil en flujos de CI/CD donde cada paso ocurre en una etapa o job diferente.

<Callout type="warn">
  **¡Solo para uso en producción!**

  Este comando está pensado para compilaciones de producción y **no debe usarse en desarrollo**.
  Recuerda especificar tu clave de API de producción (`GT_API_KEY`) y el ID del proyecto (`GT_PROJECT_ID`) en tus variables de entorno.
</Callout>

## Cómo funciona

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

## Opciones

El comando `download` acepta las mismas opciones que [`translate`](/docs/cli/translate#flags).

| Parámetro         | Descripción                                                                  | Tipo     | Opcional | Predeterminado     |
| ----------------- | ---------------------------------------------------------------------------- | -------- | -------- | ------------------ |
| `--api-key`       | Especifica una clave de API de producción                                    | `string` | `true`   |                    |
| `--project-id`    | Especifica el ID del proyecto                                                | `string` | `true`   |                    |
| `--version-id`    | Especifica un ID de versión (de forma predeterminada, un hash del contenido) | `string` | `true`   |                    |
| `--config <path>` | Especifica la ruta al archivo de configuración de GT                         | `string` | `true`   | `"gt.config.json"` |

| `--timeout`                     | Tiempo de espera de la solicitud, en segundos                                      | `number`   | `true`   | `900`              |
| `--new, --locales <locales>`    | Configuraciones regionales a las que traducir tu proyecto                          | `[string]` | `true`   |                    |
| `--default-locale <locale>`     | La configuración regional de origen del proyecto                                   | `string`   | `true`   | `en`               |
| `--dry-run`                     | Ejecuta el comando en modo de prueba                                               | `flag`     | `true`   | `false`            |
| `--force`                       | Fuerza la descarga de todas las traducciones y sobrescribe los cambios locales     | `flag`     | `true`   | `false`            |
| `--force-download`              | Fuerza la descarga de todas las traducciones y sobrescribe los cambios locales     | `flag`     | `true`   | `false`            |

## Ejemplo: flujo de CI dividido

```bash
# Etapa 1: Carga de archivos fuente
npx gt upload

# Etapa 2: Encolar traducciones
npx gt enqueue

# Etapa 3: Descargar cuando esté listo
npx gt download
```