# General Translation Platform: Inicio rápido
URL: https://generaltranslation.com/es/docs/platform/core/quickstart.mdx
---

title: Inicio rápido
description: Aprende qué hace la biblioteca Core `generaltranslation`, cuándo usarla y cómo traducir tu primera cadena.
related:
  links:
    - /docs/platform/core/guides/translating-strings
    - /docs/platform/core/guides/translating-files
    - /docs/platform/core/guides/locale-codes

---

La biblioteca `generaltranslation` es la biblioteca Core de i18n de General Translation para traducción, formato y utilidades de configuración regional.

La mayoría de las aplicaciones basadas en frameworks deberían empezar con [gt-react o gt-next](/docs/react/overview). Usa `generaltranslation` directamente cuando quieras un control más granular, un flujo de trabajo personalizado o utilidades de traducción fuera de una integración con un framework.

## Qué hace `generaltranslation` [#what-it-does]

`generaltranslation` te da acceso directo a:

* **Traducción de cadenas** para traducir cadenas o contenido estructurado desde el código.
* **Traducción de archivos** para subir archivos fuente, poner en cola trabajos de traducción, comprobar el estado y descargar el resultado traducido.
* **Utilidades de configuración regional** para validar, comparar, resolver y mostrar códigos de configuración regional.
* **Utilidades de formato** para números, fechas, mensajes, listas y tiempo relativo según la configuración regional.

## Cuándo usar `generaltranslation` [#when-to-use]

Usa `generaltranslation` cuando necesites:

* Traducir contenido desde un script, un servicio de backend, un worker o un paso de compilación personalizado.
* Subir y descargar archivos de traducción sin usar la CLI.
* Crear automatizaciones de traducción personalizadas en torno a archivos de proyecto, trabajos, ramas o etiquetas.
* Dar formato a números, fechas, mensajes o nombres de configuraciones regionales fuera de React o Next.js.
* Compartir el comportamiento de GT entre paquetes que no usan el mismo framework de frontend.

## Inicio rápido [#quickstart]

Instala `generaltranslation`, crea una instancia de [GT](/docs/platform/core/reference/gt-class/constructor) con tu ID del proyecto y tu clave de API, y traduce tu primera cadena.

### 1. Instala `generaltranslation`

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install generaltranslation
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add generaltranslation
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add generaltranslation
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add generaltranslation
    ```
  </Tab>
</Tabs>

### 2. Obtén una clave de API

Crea un `GT_PROJECT_ID` y una `GT_API_KEY` en el panel de control. Abre la [página de API Keys](https://dash.generaltranslation.com/api-keys), haz clic en **Create API Key**, escribe un nombre y confirma.

```bash
GT_PROJECT_ID=your-project-id
GT_API_KEY=your-api-key
```

General Translation ofrece límites de uso gratuitos generosos para proyectos personales, desarrolladores independientes y la comunidad.

### 3. Inicializa la clase GT

Inicializa la clase [GT](/docs/platform/core/reference/gt-class/constructor) y proporciona de forma segura tu `GT_PROJECT_ID` y tu `GT_API_KEY`.

```typescript title="src/index.ts"
import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});
```

Puede configurar las configuraciones regionales predeterminadas en la instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Use configuraciones regionales predeterminadas cuando la mayoría de las llamadas utilicen la misma configuración regional de origen o de destino.

```typescript title="src/index.ts"
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
  sourceLocale: 'en',
  targetLocale: 'es',
});
```

Consulta [GT class](/docs/platform/core/reference/gt-class/constructor) para conocer todas las opciones del constructor.

### 4. Traduce tu primera cadena

Llama al método [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) para traducir tu primera cadena. Indica la cadena que quieres traducir y la configuración regional de destino.

```typescript title="src/index.ts"
const result = await gt.translate('Hello, world!', 'es');

if (result.success) {
  console.log(result.translation); // "¡Hola, mundo!"
} else {
  console.error(`Translation failed: ${result.error}`);
}
```

Los métodos de traducción requieren una clave de API y un ID del proyecto. Las utilidades de formato y de configuración regional pueden usarse sin acceso a la API de traducción.
## Next steps

- /docs/platform/core/guides/translating-strings
- /docs/platform/core/guides/translating-files
- /docs/platform/core/guides/locale-codes