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

title: gt stage
description: Envía un proyecto para traducción asíncrona y descarga posterior. Referencia de API para el comando gt stage.

---

Envía tu proyecto para su traducción asíncrona sin descargar ni publicar los resultados en la misma ejecución. Úsalo cuando tu Project tenga habilitada la revisión humana o cuando un formato como Lottie no pueda completarse en una sola ejecución de [`gt translate`](/docs/cli/reference/commands/translate). Para ambos flujos de trabajo, consulta [Administrar traducciones](/docs/cli/guides/managing-translations).

Ejecutar `stage` establece `stageTranslations: true` en tu `gt.config.json`. Una vez habilitado, ejecutar [`gt translate`](/docs/cli/reference/commands/translate) sin antes preparar una versión determinada con `stage` hace que el CLI finalice con un error. Cuando las traducciones estén listas —y aprobadas si se requiere revisión—, ejecuta [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) también puede descargar una versión preparada anteriormente.

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

```bash
npx gt stage
```

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

1. Lee `gt.config.json`, analiza tu código fuente en busca de contenido inline en proyectos con frameworks y recopila archivos, igual que [`gt translate`](/docs/cli/reference/commands/translate).
2. Envía el contenido a la API de General Translation sin descargar ni publicar los resultados en la misma ejecución. Los Projects con revisión obligatoria retienen las traducciones completadas para su aprobación.
3. Establece `stageTranslations: true` en tu `gt.config.json` para que las ejecuciones futuras requieran preparar.

Una vez que `stageTranslations` está habilitado, ejecutar [`translate`](/docs/cli/reference/commands/translate) sin antes preparar esa versión hace que la CLI termine con un error. Descarga las traducciones completadas con [`gt download`](/docs/cli/reference/commands/download), o usa [`gt translate`](/docs/cli/reference/commands/translate) para cualquier versión preparada previamente.

## Opciones [#flags]

`stage` acepta las mismas opciones que [`gt translate`](/docs/cli/reference/commands/translate#flags), incluidas las opciones de escaneo del código fuente para proyectos con frameworks. A continuación se muestran las opciones que más se usan; la referencia enlazada arriba incluye la lista completa.

| Parámetro                   | Descripción                                                                                     | Tipo       | Opcional | Predeterminado   |
| --------------------------- | ----------------------------------------------------------------------------------------------- | ---------- | -------- | ---------------- |
| `--api-key <key>`           | Clave de API de producción.                                                                     | `string`   | Sí       | `GT_API_KEY`     |
| `--project-id <id>`         | ID del proyecto.                                                                                | `string`   | Sí       | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | Ruta al archivo de configuración.                                                               | `string`   | Sí       | `gt.config.json` |
| `--locales <locales...>`    | configuraciones regionales de destino adicionales, añadidas a `locales` de la configuración.    | `string[]` | Sí       | —                |
| `--default-locale <locale>` | configuración regional de origen del proyecto.                                                  | `string`   | Sí       | `en`             |
| `--dry-run`                 | Analiza y valida sin llamar a la API.                                                           | `boolean`  | Sí       | `false`          |
| `--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í       | —                |

## Ejemplo [#example]

```bash
# Preparar traducciones para revisión humana
npx gt stage

# Preparar y etiquetar la ejecución para seguimiento en el panel de control
npx gt stage --tag v2.1.0 -m "Q3 release"

# Cuando las traducciones estén listas, descargarlas
npx gt download
```

## Otras notas [#notes]

* Usa `stage` cuando la revisión humana esté habilitada o al traducir formatos asíncronos como [Lottie](/docs/cli/reference/formats/lottie-files).
* Al preparar, se establece la clave de configuración [`stageTranslations`](/docs/cli/reference/config#stage). Consulta [Preparar traducciones para revisión](/docs/cli/guides/managing-translations#review).