# generaltranslation: General Translation Core SDK: Constructor de GT
URL: https://generaltranslation.com/es/docs/core/class/constructor.mdx
---
title: Constructor de GT
description: Referencia de la API del constructor de la clase GT
---

## Resumen

El constructor `GT` crea una nueva instancia de la clase General Translation, que proporciona acceso a toda la funcionalidad de traducción, formato y configuración regional.

```typescript
import { GT } from 'generaltranslation';

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

El constructor comprobará automáticamente si en el entorno están definidas las variables `GT_API_KEY` y `GT_PROJECT_ID`, por lo que puedes omitirlas en los parámetros del constructor.
Además, validará todos los códigos de configuración regional proporcionados.

***


## Referencia

### Parámetros

<TypeTable
  type={{
  "params": {
    type: 'GTConstructorParams',
    optional: true,
    default: '{}',
  }
}}
/>

El objeto `GTConstructorParams` admite las siguientes propiedades:

| Propiedad       | Tipo            | Opcional | Descripción                                                                     |
| --------------- | --------------- | -------- | ------------------------------------------------------------------------------- |
| `apiKey`        | `string`        | ✓        | Clave API de producción para el servicio de traducción                          |
| `devApiKey`     | `string`        | ✓        | Clave API de desarrollo (tiene prioridad en desarrollo)                         |
| `projectId`     | `string`        | ✓        | Identificador único del proyecto                                                |
| `sourceLocale`  | `string`        | ✓        | Configuración regional de origen predeterminada para la traducción              |
| `targetLocale`  | `string`        | ✓        | Configuración regional de destino predeterminada para la traducción             |
| `locales`       | `string[]`      | ✓        | Array de códigos de configuración regional compatibles                          |
| `baseUrl`       | `string`        | ✓        | URL base personalizada de la API (para despliegues Enterprise)                  |
| `customMapping` | `CustomMapping` | ✓        | Asignaciones y definiciones personalizadas de códigos de configuración regional |

### Devuelve

Una nueva instancia de la clase `GT` con todos los métodos de traducción y de configuración regional disponibles.

***

## Ejemplos

### Uso básico

```typescript
import { GT } from 'generaltranslation';

// Configuración mínima - usa variables de entorno
const gt = new GT();
```


### Con credenciales de la API

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


### Con una asignación personalizada de configuración regional

Se puede proporcionar una asignación personalizada.
Esto permite al usuario (1) usar alias para códigos de configuración regional que (2) pueden sobrescribir la validación estándar de BCP 47 y (3) sobrescribir la información estándar de configuración regional de BCP 47.

Por ejemplo, supongamos que quieres usar `cn` como alias de `zh`.
Como la API de General Translation no admite `cn`, debes especificar una asignación personalizada.

```typescript
const gt = new GT({
  projectId: 'my-project-id',
  apiKey: 'my-api-key',
  targetLocale: 'es',
  customMapping: {
    'cn': { code: 'zh' }
  }
});
```

Puedes hacer otras cosas con las asignaciones personalizadas, como añadir nombres personalizados, emojis, etc.

```typescript
const gt = new GT({
  projectId: 'my-project-id',
  apiKey: 'my-api-key',
  targetLocale: 'es',
  customMapping: { 'en-US': { name: 'Mandarin', emoji: '🇫🇷' } }
});
```

***


## Notas

* Todos los parámetros son opcionales, pero las operaciones de la API requieren `apiKey` y `projectId`
* El constructor valida de inmediato todos los códigos de configuración regional y genera errores si alguno no es válido
* Las asignaciones personalizadas tienen prioridad sobre la validación estándar de BCP 47

## Siguientes pasos

* Configura tu instancia con [`setConfig`](/docs/core/class/set-config)
* Empieza a traducir con [`translate`](/docs/core/class/methods/translation/translate)
* Más información sobre el [tipo `GTConstructorParams`](/docs/core/types/gt-constructor-params)