# 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: esta guía cubre 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: A diferencia de `gt-next`, `gt-node` no lee `gt.config.json` ni las variables de entorno automáticamente. Debes pasar cada valor explícitamente.*

## Inicializar al arrancar [#initialize]

Llama a `initializeGT` 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'],
  projectId: process.env.GT_PROJECT_ID,
});
```

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 tu clave de API como variables de entorno y pásalos. Usa la clave de desarrollo mientras desarrollas y la clave de producción en producción.

```ts title="server.js"
initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
  projectId: process.env.GT_PROJECT_ID,
  devApiKey: process.env.NODE_ENV !== 'production' ? process.env.GT_API_KEY : undefined,
  apiKey: process.env.NODE_ENV === 'production' ? process.env.GT_API_KEY : undefined,
});
```

En desarrollo, un `projectId` 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` 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