# 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 para el constructor de la clase GT
---

## Descripción general

El constructor `GT` crea una nueva instancia de la clase General Translation, que da acceso a todas las funciones 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`, `GT_DEV_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 de API de producción para el servicio de traducción                       |
| `devApiKey`     | `string`        | ✓        | Clave de API de desarrollo (tiene prioridad en el entorno de desarrollo)        |
| `projectId`     | `string`        | ✓        | Identificador único del proyecto                                                |
| `sourceLocale`  | `string`        | ✓        | Configuración regional de origen predeterminada para las traducciones           |
| `targetLocale`  | `string`        | ✓        | Configuración regional de destino predeterminada para las traducciones          |
| `locales`       | `string[]`      | ✓        | Array de códigos de configuración regional compatibles                          |
| `baseUrl`       | `string`        | ✓        | URL base de la API personalizada (para implementaciones empresariales)          |
| `customMapping` | `CustomMapping` | ✓        | Definiciones y asignaciones 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 un mapeo personalizado de configuración regional

Se puede proporcionar un mapeo personalizado.
Esto permite al usuario (1) usar alias para los códigos de configuración regional que (2) pueden omitir la validación estándar de BCP 47 y (3) reemplazar 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 un mapeo personalizado.

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

Con los mapeos personalizados también puedes hacer otras cosas, 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 requerirán `apiKey` y `projectId`
* El constructor valida de inmediato todos los códigos de configuración regional y arroja errores si algún código no es válido
* Los mapeos personalizados prevalecen sobre la validación estándar de BCP 47

## Próximos 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)