# 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-api-your-runtime-key"
export GT_API_KEY="gtx-api-..."
```

Utilisez une [clé API de projet](/docs/platform/dashboard/reference/api-keys#create-project-keys) avec la permission **traduction à l’exécution** activée. `GT_DEV_API_KEY` active le rechargement à chaud en développement ; `GT_API_KEY` fournit les identifiants pour les autres requêtes à l’exécution. Les deux acceptent les clés de projet `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 projet disposant de la permission de traduction à l’exécution 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.