# gt: General Translation CLI tool: Cargar
URL: https://generaltranslation.com/es/docs/cli/upload.mdx
---
title: Cargar
description: Cómo cargar archivo fuente y traducciones en la plataforma de General Translation
---

## Uso

```bash
npx gt upload
```

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


## Resumen

El comando `gt upload` carga los archivos fuente de tu proyecto y cualquier traducción existente en la plataforma de General Translation. Esto sincroniza tus archivos locales con la plataforma para que se puedan gestionar, poner en cola para su traducción y hacerles seguimiento.

El flujo de trabajo típico para pipelines de CI/CD separados es:

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

<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 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 qué archivos cargar
2. Recopila todos los archivos fuente traducibles (JSON, YAML, Markdown, MDX, etc.)
3. Genera un hash para cada archivo a fin de crear un `fileId` (basado en la ruta) y un `versionId` (basado en el contenido)
4. Consulta la API de General Translation para determinar qué archivos son nuevos o han cambiado
5. Detecta movimientos de archivos (mismo contenido, ruta diferente) y conserva las traducciones existentes
6. Carga en la plataforma los archivos fuente nuevos y modificados
7. Si encuentra de forma local archivos de traducción existentes, también los carga

## Opciones

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

| Parámetro                    | Descripción                                                      | Tipo       | Opcional | Por defecto        |
| ---------------------------- | ---------------------------------------------------------------- | ---------- | -------- | ------------------ |
| `--api-key`                  | Especifica una clave API de producción                           | `string`   | `true`   |                    |
| `--project-id`               | Especifica el ID del proyecto                                    | `string`   | `true`   |                    |
| `--version-id`               | Especifica un ID de versión (por defecto, un hash del contenido) | `string`   | `true`   |                    |
| `--config <path>`            | Especifica la ruta al archivo de configuración de GT             | `string`   | `true`   | `"gt.config.json"` |
| `--new, --locales <locales>` | Locales a los 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 simulación                         | `flag`     | `true`   | `false`            |
| `--timeout`                  | El tiempo de espera de la solicitud en segundos                  | `number`   | `true`   | `600`              |

## Ejemplo: pipeline de CI separada

```bash
# Etapa 1: Cargar archivos fuente
npx gt upload

# Etapa 2: Poner en cola las traducciones
npx gt enqueue

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