# General Translation Python SDKs: Configuration
URL: https://generaltranslation.com/fr/docs/python/reference/config.mdx
---

title: Configuration
description: Configurez le SDK Python de General Translation via le fichier gt.config.json. Référence API de gt.config.json.

---

`gt.config.json` contient les paramètres partagés d’un projet Python General Translation. [`initialize_gt`](/docs/python/reference/functions/initialize-gt) le lit au démarrage (ou vous transmettez ses valeurs à un [`I18nManager`](/docs/python/reference/classes/i18n-manager)), et les arguments nommés que vous fournissez remplacent ceux du fichier. Cette page documente chaque clé lue par le SDK.

*Remarque : le SDK Python est expérimental.*

## Aperçu [#overview]

Placez `gt.config.json` à la racine de votre projet (c’est-à-dire le répertoire de travail actuel par défaut ; vous pouvez le remplacer avec `initialize_gt(..., config_path=...)`). Les clés du fichier utilisent le format **camelCase**. Toutes les clés sont facultatives ; les clés inconnues sont ignorées. Si le fichier par défaut est absent, une configuration vide est utilisée — mais si un `config_path` explicite n’existe pas, une erreur `FileNotFoundError` est levée, et si le JSON est invalide, une erreur `ValueError` est levée.

```json title="gt.config.json"
{
  "projectId": "your-project-id",
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "cacheUrl": "https://cdn.gtx.dev"
}
```

| Clé                                | Description                                                   | Type       | Facultatif | Par défaut |
| ---------------------------------- | ------------------------------------------------------------- | ---------- | ---------- | ---------- |
| [`projectId`](#project-id)         | ID de projet ; active le loader CDN lorsqu’il est défini.     | `string`   | Oui        | —          |
| [`defaultLocale`](#default-locale) | Paramètre régional source et de secours.                      | `string`   | Oui        | `"en"`     |
| [`locales`](#locales)              | Codes de langue cibles pris en charge.                        | `string[]` | Oui        | —          |
| [`cacheUrl`](#cache-url)           | URL de base du CDN utilisée pour charger les traductions.     | `string`   | Oui        | —          |
| [`customMapping`](#custom-mapping) | Codes de langue personnalisés et remplacements de propriétés. | `object`   | Oui        | —          |
| [`_versionId`](#version-id)        | Version de traduction épinglée.                               | `string`   | Oui        | —          |
| [`runtimeUrl`](#runtime-url)       | URL de base de l’API Runtime.                                 | `string`   | Oui        | —          |

## `projectId` [#project-id]

**Type** `string` · **Facultatif**

L’ID de votre projet General Translation. S’il est défini (et qu’aucun callback `load_translations` n’est fourni), le SDK charge les traductions depuis le CDN à l’adresse `{cacheUrl}/{projectId}/{locale}`. Correspond à l’argument `project_id` de `initialize_gt` et de `I18nManager`.

## `defaultLocale` [#default-locale]

**Type** `string` · **Facultatif** · **Par défaut** `"en"`

Le paramètre régional source dans lequel est rédigé votre contenu, ainsi que le paramètre régional de secours lorsqu’aucune traduction n’est trouvée. S’il n’est défini ni dans la configuration ni lors de l’appel à `initialize_gt`, la valeur par défaut de la bibliothèque, `"en"`, est utilisée (la constante `LIBRARY_DEFAULT_LOCALE`).

## `locales` [#locales]

**Type** `string[]` · **Facultatif**

Les paramètres régionaux cibles à prendre en charge. Le paramètre régional par défaut est toujours inclus dans l'ensemble des paramètres régionaux du gestionnaire, même s'il est omis ici. Le chargement anticipé récupère les traductions de ces paramètres régionaux au démarrage.

## `cacheUrl` [#cache-url]

**Type** `string` · **Facultatif**

L’URL de base du CDN utilisée pour construire les requêtes de traduction (`{cacheUrl}/{projectId}/{locale}`). Le CDN de General Translation est `https://cdn.gtx.dev`.

*Remarque : lorsque `cacheUrl` n’est pas défini, le gestionnaire transmet actuellement une URL de base vide au loader distant au lieu d’utiliser la valeur par défaut du CDN — définissez `cacheUrl` explicitement pour le chargement depuis le CDN.*

## `customMapping` [#custom-mapping]

**Type** `object` · **Facultatif**

Mappage de codes de langue personnalisés vers des codes standard ou des remplacements de propriétés (par exemple, `{ "en-US": { "name": "English", "nativeName": "English" } }`). Correspond à l’argument `custom_mapping` et au type [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) dans `generaltranslation`.

## `_versionId` [#version-id]

**Type** `string` · **Facultatif**

Version de traduction figée à charger. Notez l’underscore initial dans la clé de fichier : il correspond à l’argument `version_id` de `initialize_gt` et de `I18nManager`, et est renvoyé par [`get_version_id`](/docs/python/reference/functions/get-version-id).

## `runtimeUrl` [#runtime-url]

**Type** `string` · **Facultatif**

L’URL de base de l’API runtime. Le loader de configuration convertit cette clé en `runtime_url`, mais les intégrations actuelles `gt-flask` et `gt-fastapi` ne la transmettent pas au gestionnaire ; elle n’a donc aucun effet à l’exécution.

*Remarque : `runtimeUrl` est lu, mais n’est pas utilisé par les intégrations des frameworks.*