# gt-node: General Translation Node.js SDK: initializeGT
URL: https://generaltranslation.com/es/docs/node/reference/functions/initialize-gt.mdx
Docs index: https://generaltranslation.com/llms.txt
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. Lee las credenciales alternativas de `GT_PROJECT_ID`, `GT_API_KEY` y `GT_DEV_API_KEY`, pero no lee `gt.config.json` automáticamente. 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'],
});
```

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.
* **Precedencia de credenciales.** Los valores explícitos y no vacíos de `projectId`, `apiKey` y `devApiKey` tienen prioridad. Los valores omitidos o vacíos recurren a sus variables de entorno correspondientes.
* **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, credencial, 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 contenido alternativo (valor predeterminado: `'en'`).
* `locales` — configuraciones regionales de destino admitidas.
* `projectId` — ID del proyecto; habilita el loader de traducción de CDN al establecerlo.
* `apiKey` — clave de API de producción.
* `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'],
  // Las credenciales se leen de GT_PROJECT_ID, GT_API_KEY y GT_DEV_API_KEY.
});
```

```ts title="server.js"
// Con un loader de traducción 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();
  },
});
```

## Historial de versiones [#version-history]

| Versión         | Cambios                                                                                                                                                            |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `gt-node` 1.0.8 | Se agregaron valores alternativos de entorno para `GT_PROJECT_ID`, `GT_API_KEY` y `GT_DEV_API_KEY`. Los parámetros explícitos no vacíos siguen teniendo prioridad. |

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.