# gt-node: General Translation Node.js SDK: Configuración de gt-node
URL: https://generaltranslation.com/es/docs/node/guides/configuring.mdx
---
title: Configuración de gt-node
description: Cómo inicializar General Translation gt-node con locales, credenciales y la entrega de traducciones.
related:
  links:
    - /docs/node/guides/translating-strings
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/storing-translations

---

`gt-node` se configura por completo mediante la llamada a [`initializeGT`](/docs/node/reference/functions/initialize-gt) que haces una sola vez al iniciar. Esta guía explica qué valores debes pasar y cómo se entregan las traducciones.

*Nota: `gt-node` no lee `gt.config.json` automáticamente. Sí lee `GT_PROJECT_ID`, `GT_API_KEY` y `GT_DEV_API_KEY` como credenciales alternativas.*

## Inicializar al arrancar [#initialize]

Llama a [`initializeGT`](/docs/node/reference/functions/initialize-gt) una sola vez, antes de procesar cualquier solicitud, con tus locales y credenciales.

```ts title="server.js"
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
});
```

Para mantener los valores sincronizados con la CLI, importa tu `gt.config.json` y usa sus campos con spread en la llamada.

## Añade credenciales [#credentials]

Configura tu Project ID y tus claves de API en el entorno en el que se ejecuta el servicio. [`initializeGT`](/docs/node/reference/functions/initialize-gt) los usa cuando omites los campos correspondientes:

```bash
export GT_PROJECT_ID="your-project-id"
export GT_DEV_API_KEY="gtx-dev-..."
export GT_API_KEY="gtx-api-..."
```

Los valores pasados directamente a [`initializeGT`](/docs/node/reference/functions/initialize-gt) tienen prioridad sobre las variables de entorno. Un valor explícito vacío usa el valor del entorno como respaldo.

En desarrollo, un Project ID y una clave API de desarrollo permiten la traducción on-demand y el hot reload, para que las nuevas cadenas se traduzcan mientras trabajas. En producción, las traducciones provienen de tus archivos pregenerados o de la CDN. Consulta la [Referencia de configuración](/docs/node/reference/config) para consultar todas las opciones.

## Elige cómo se obtienen las traducciones [#delivery]

`gt-node` obtiene las traducciones de una de estas formas:

* **General Translation CDN:** proporciona un `projectId` (sin un `loader` personalizado) para obtener las traducciones desde la CDN de GT.
* **Archivos locales:** proporciona un callback de [`loadTranslations`](/docs/react/reference/functions/load-translations) que devuelva las traducciones para una configuración regional. Consulta [Almacenar traducciones localmente](/docs/node/guides/storing-translations).
* **Endpoint personalizado:** establece un `cacheUrl` personalizado para cargar las traducciones desde tu propio host, o `null` para desactivar la carga remota.

## Gestionar traducciones faltantes [#missing]

Cuando falta una traducción, `gt-node` devuelve la cadena fuente interpolada con tus variables en lugar de lanzar una excepción, por lo que una solicitud siempre se renderiza. Las búsquedas en el diccionario mediante [`getTranslations`](/docs/node/reference/functions/get-translations) son la excepción: si el id del diccionario es desconocido, se lanza una excepción. Mantén los valores de [`initializeGT`](/docs/node/reference/functions/initialize-gt) alineados con lo que genera la CLI para que en producción las traducciones estén listas.
## Next steps

- /docs/node/guides/translating-strings
- /docs/node/guides/detecting-locale
- /docs/node/guides/storing-translations