# gt-node: General Translation Node.js SDK: Configuration de gt-node
URL: https://generaltranslation.com/fr/docs/node/guides/configuring.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Comment initialiser General Translation gt-node avec des paramètres régionaux, des identifiants et le mode de livraison des traductions.

`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 livrées.

*Remarque : contrairement à `gt-next`, `gt-node` ne lit pas automatiquement `gt.config.json` : importez explicitement ce fichier pour partager ses paramètres régionaux avec le runtime. En revanche, il lit `GT_PROJECT_ID`, `GT_API_KEY` et `GT_DEV_API_KEY` comme identifiants de secours.*

## Initialiser au démarrage [#initialize]

Appelez [`initializeGT`](/docs/node/reference/functions/initialize-gt) 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'],
});
```

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 vos clés API dans l’environnement où le service s’exécute. [`initializeGT`](/docs/node/reference/functions/initialize-gt) les utilise si vous omettez les champs correspondants :

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

Les valeurs passées directement à [`initializeGT`](/docs/node/reference/functions/initialize-gt) prévalent sur les variables d’environnement. Une valeur explicite vide utilise alors la valeur de l’environnement.

En développement, un ID de projet 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`](/docs/node/reference/functions/initialize-gt) 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

## Sitemap

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