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

title: Configurazione
description: Configura l'SDK Python di General Translation tramite il file gt.config.json. Riferimento API per gt.config.json.

---

`gt.config.json` contiene le impostazioni condivise per un progetto Python di General Translation. [`initialize_gt`](/docs/python/reference/functions/initialize-gt) lo legge all'avvio (oppure puoi passare i relativi valori a un [`I18nManager`](/docs/python/reference/classes/i18n-manager)) e gli eventuali argomenti keyword che passi sovrascrivono il file. Questa pagina documenta ogni chiave letta dall'SDK.

*Nota: l'SDK Python è sperimentale.*

## Panoramica [#overview]

Colloca `gt.config.json` nella radice del progetto (per impostazione predefinita, la directory di lavoro corrente; puoi sovrascriverla con `initialize_gt(..., config_path=...)`). Nel file, le chiavi usano il formato **camelCase**. Tutte le chiavi sono facoltative; quelle sconosciute vengono ignorate. Se il file predefinito non è presente, viene usata una configurazione vuota — ma se `config_path` è specificato esplicitamente e non esiste, viene generato `FileNotFoundError`; se il JSON non è valido, viene generato `ValueError`.

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

| Chiave                             | Descrizione                                              | Tipo       | Facoltativo | Predefinito |
| ---------------------------------- | -------------------------------------------------------- | ---------- | ----------- | ----------- |
| [`projectId`](#project-id)         | ID progetto; abilita il loader CDN se impostato.         | `string`   | Sì          | —           |
| [`defaultLocale`](#default-locale) | Impostazione regionale sorgente e di fallback.           | `string`   | Sì          | `"en"`      |
| [`locales`](#locales)              | Codici locale di destinazione supportati.                | `string[]` | Sì          | —           |
| [`cacheUrl`](#cache-url)           | URL di base del CDN usato per caricare le traduzioni.    | `string`   | Sì          | —           |
| [`customMapping`](#custom-mapping) | Codici locale personalizzati e override delle proprietà. | `object`   | Sì          | —           |
| [`_versionId`](#version-id)        | Versione di traduzione bloccata.                         | `string`   | Sì          | —           |
| [`runtimeUrl`](#runtime-url)       | URL di base dell'API Runtime.                        | `string`   | Sì          | —           |

## `projectId` [#project-id]

**Tipo** `string` · **Facoltativo**

L'ID progetto di General Translation. Quando è impostato (e non viene fornita alcuna callback `load_translations`), l’SDK carica le traduzioni dalla CDN all’indirizzo `{cacheUrl}/{projectId}/{locale}`. Corrisponde all’argomento `project_id` di `initialize_gt` e `I18nManager`.

## `defaultLocale` [#default-locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** `"en"`

L'impostazione regionale sorgente in cui sono scritti i tuoi contenuti e l'impostazione regionale di fallback usata quando non viene trovata alcuna traduzione. Se non è impostata né nella configurazione né nella chiamata `initialize_gt`, viene utilizzata l'impostazione predefinita della libreria `"en"` (la costante `LIBRARY_DEFAULT_LOCALE`).

## `locales` [#locales]

**Tipo** `string[]` · **Facoltativo**

Le impostazioni regionali di destinazione da supportare. L'impostazione regionale predefinita è sempre inclusa nell'insieme delle impostazioni regionali del manager, anche se qui viene omessa. Il caricamento anticipato recupera le traduzioni per queste impostazioni regionali all'avvio.

## `cacheUrl` [#cache-url]

**Tipo** `string` · **Facoltativo**

L'URL di base della CDN utilizzato per costruire le richieste di traduzione (`{cacheUrl}/{projectId}/{locale}`). La CDN di General Translation è `https://cdn.gtx.dev`.

*Nota: quando `cacheUrl` non è impostato, il manager attualmente passa un URL di base vuoto al loader remoto invece di usare il valore predefinito della CDN: imposta quindi `cacheUrl` esplicitamente per il caricamento dalla CDN.*

## `customMapping` [#custom-mapping]

**Tipo** `object` · **Facoltativo**

Una mappatura di codici locale personalizzati a codici standard o a override di proprietà (ad esempio, `{ "en-US": { "name": "English", "nativeName": "English" } }`). Corrisponde all'argomento `custom_mapping` e al tipo [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) in `generaltranslation`.

## `_versionId` [#version-id]

**Tipo** `string` · **Facoltativo**

Una versione di traduzione fissata da caricare. Nota il trattino basso iniziale nella chiave del file: corrisponde all'argomento `version_id` di `initialize_gt` e `I18nManager` ed è restituito da [`get_version_id`](/docs/python/reference/functions/get-version-id).

## `runtimeUrl` [#runtime-url]

**Tipo** `string` · **Facoltativo**

L'URL di base della Runtime API. Il loader di configurazione converte questa chiave in `runtime_url`, ma le attuali integrazioni `gt-flask` e `gt-fastapi` non la passano al manager, quindi non ha alcun effetto in fase di runtime.

*Nota: `runtimeUrl` viene letto ma non utilizzato dalle integrazioni del framework.*