# 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 a General Translation con revisión humana obligatoria. Referencia de API para el comando gt stage.

---

Envía tu proyecto para su traducción y deja los resultados pendientes de revisión humana en lugar de descargarlos o publicarlos. Úsalo cuando tu proyecto tenga habilitada la revisión humana. Para el flujo de revisión, consulta [Administrar traducciones](/docs/cli/guides/managing-translations#review).

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. Después de que se aprueben las traducciones, ejecuta [`translate`](/docs/cli/reference/commands/translate) para descargarlas.

*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 basados en frameworks y recopila archivos, igual que [`gt translate`](/docs/cli/reference/commands/translate).
2. Envía el contenido a la API de General Translation y deja los resultados pendientes de revisión humana en lugar de descargarlos o publicarlos.
3. Establece `stageTranslations: true` en tu `gt.config.json` para que las ejecuciones futuras requieran preparar.

Una vez que `stageTranslations` está habilitado, ejecutar `translate` sin antes preparar esa versión hace que la CLI termine con un error. Cuando se aprueben las traducciones, ejecuta `translate` para descargarlas.

## 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"

# Una vez aprobadas las traducciones, descargarlas
npx gt translate
```

## Otras notas [#notes]

* `stage` solo es útil cuando la revisión humana está habilitada en tu proyecto.
* 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).