# gt-node: General Translation Node.js SDK: Configuration de gt-node
URL: https://generaltranslation.com/fr/docs/node/guides/configuring.mdx
---

title: Configuration de gt-node
description: "Comment initialiser General Translation gt-node : ce guide présente les paramètres régionaux, les identifiants et le mode d’acheminement des traductions."
related:
  links:
    - /docs/node/guides/translating-strings
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/storing-translations

---

`gt-node` se configure entièrement via l’appel à [`initializeGT`](/docs/node/reference/functions/initialize-gt), que vous effectuez une seule fois au démarrage. Ce guide explique quels paramètres fournir et comment les traductions sont acheminées.

*Remarque : contrairement à `gt-next`, `gt-node` ne lit pas automatiquement `gt.config.json` ni les variables d’environnement. Fournissez chaque valeur explicitement.*

## Initialiser au démarrage [#initialize]

Appelez `initializeGT` une seule fois, avant de traiter toute requête, avec vos paramètres régionaux et vos identifiants.

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

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

Pour que les valeurs restent synchronisées avec la CLI, importez votre `gt.config.json` et utilisez l’opérateur spread pour inclure ses champs dans l’appel.

## Ajoutez des identifiants [#credentials]

Définissez votre ID de projet et votre clé API comme variables d’environnement, puis passez-les en paramètres. Utilisez la clé de développement pendant le développement et la clé de production en production.

```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 développement, un `projectId` et une clé API de développement activent la traduction à la demande et le rechargement à chaud, afin que les nouvelles chaînes soient traduites au fur et à mesure de votre travail. En production, les traductions proviennent de vos fichiers pré-générés ou du CDN. Consultez la [référence de configuration](/docs/node/reference/config) pour connaître toutes les options.

## Choisissez comment les traductions sont chargées [#delivery]

`gt-node` charge les traductions selon l'un des modes suivants :

* **CDN de General Translation :** fournissez un `projectId` (sans `loader` personnalisé) pour récupérer les traductions depuis le CDN de GT.
* **Fichiers locaux :** fournissez un callback [`loadTranslations`](/docs/react/reference/functions/load-translations) qui renvoie les traductions pour un paramètre régional. Voir [Stocker les traductions localement](/docs/node/guides/storing-translations).
* **Endpoint personnalisé :** définissez un `cacheUrl` personnalisé pour charger les traductions depuis votre propre hôte, ou `null` pour désactiver le chargement à distance.

## Gérer les traductions manquantes [#missing]

Lorsqu’une traduction manque, `gt-node` renvoie la chaîne source interpolée avec vos variables au lieu de lever une exception, de sorte qu’une requête génère toujours un rendu. Les recherches dans le dictionnaire via [`getTranslations`](/docs/node/reference/functions/get-translations) font exception : un id de dictionnaire inconnu lève une exception. Veillez à ce que les valeurs de `initializeGT` correspondent à celles générées par le CLI afin qu’en production, les traductions soient prêtes.
## Next steps

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