# gt-node: General Translation Node.js SDK: initializeGT
URL: https://generaltranslation.com/es/docs/node/reference/functions/initialize-gt.mdx
---

title: initializeGT
description: Configura la biblioteca gt-node de General Translation una sola vez al iniciar el servidor. Referencia de la API de initializeGT.

---

Configura General Translation para usarlo en un entorno de ejecución de Node.js. Llama a `initializeGT` una vez, antes de cualquier otra función de traducción, para establecer las configuraciones regionales, las credenciales y la entrega de traducciones.

## Descripción general [#overview]

Llama a `initializeGT` al inicio del archivo de entrada de tu servidor. No lee automáticamente ninguna de tus variables de entorno ni tus archivos de configuración; debes pasar cada valor explícitamente. Consulta la [referencia de configuración](/docs/node/reference/config) para ver la lista completa de opciones.

```ts
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
  projectId: 'your-project-id',
});
```

Firma:

```ts
initializeGT(config: InitializeGTParams): void
```

*Nota: Debes llamar a `initializeGT` antes de usar [`withGT`](/docs/node/reference/functions/with-gt), [`getGT`](/docs/node/reference/functions/get-gt), [`getMessages`](/docs/node/reference/functions/get-messages) o cualquier otra función de traducción. Si llamas primero a esas funciones, se producirá un error.*

## Cómo funciona [#how-it-works]

* **Configuración única.** Llama a `initializeGT` exactamente una vez durante la inicialización del servidor. Configura la configuración regional, la caché de traducciones y el almacenamiento de la configuración regional por solicitud.
* **Modo de entrega.** Proporciona `projectId` para cargar las traducciones desde la CDN de General Translation, o [`loadTranslations`](/docs/react/reference/functions/load-translations) para usar tu propia fuente de traducción. Para la traducción on-demand en desarrollo, proporciona también `devApiKey`.
* **Sincrónica.** La llamada se devuelve de inmediato y no espera solicitudes de red.

## Parámetros [#parameters]

| Parámetro           | Descripción                                                                                      | Tipo                 | Opcional | Predeterminado |
| ------------------- | ------------------------------------------------------------------------------------------------ | -------------------- | -------- | -------------- |
| [`config`](#config) | Objeto de configuración. Consulta la [referencia de configuración](/docs/node/reference/config). | `InitializeGTParams` | No       | —              |

### `config` [#config]

**Tipo** `InitializeGTParams` · **Obligatorio**

Un objeto que combina opciones de configuración regional, autenticación, caché y diccionario. El objeto es obligatorio, pero todos sus campos son opcionales. Cada campo está documentado en la [referencia de configuración](/docs/node/reference/config). Campos de uso común:

* `defaultLocale` — configuración regional de origen y de respaldo (valor predeterminado: `'en'`).
* `locales` — configuraciones regionales de destino admitidas.
* `projectId` — ID del proyecto; habilita el loader de traducción de CDN al establecerlo.
* `devApiKey` — clave de API de desarrollo para traducción on-demand.
* `loadTranslations` — loader de traducción personalizado que devuelve traducciones para una configuración regional.
* `customMapping` — alias de configuración regional y anulaciones de propiedades.

## Devuelve [#returns]

**Tipo** `void`

## Ejemplos [#examples]

```ts title="server.js"
// Configuración básica
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr', 'ja'],
  projectId: process.env.GT_PROJECT_ID,
});
```

```ts title="server.js"
// Con un translation loader personalizado
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es'],
  loadTranslations: async (locale) => {
    const res = await fetch(`https://my-api.com/translations/${locale}`);
    return res.json();
  },
});
```

## Notas [#notes]

* `initializeGT` debe llamarse una sola vez antes de ejecutar cualquier función de traducción.
* Si usas los servicios en la nube de General Translation, proporciona `projectId`; para desarrollo, proporciona también `devApiKey`.
* La opción `loadTranslations` te permite usar tu propia fuente de traducciones en lugar de la CDN de General Translation.