# General Translation Python SDKs: Configuración
URL: https://generaltranslation.com/es/docs/python/reference/config.mdx
---

title: Configuración
description: Configura el SDK de Python de General Translation mediante el archivo gt.config.json. Referencia de la API de gt.config.json.

---

`gt.config.json` contiene la configuración compartida de un proyecto de Python de General Translation. [`initialize_gt`](/docs/python/reference/functions/initialize-gt) lo lee al iniciarse (o puedes pasar sus valores a un [`I18nManager`](/docs/python/reference/classes/i18n-manager)), y cualquier argumento de palabra clave que proporciones sobrescribe los valores del archivo. Esta página documenta cada clave que lee el SDK.

*Nota: El SDK de Python es experimental.*

## Descripción general [#overview]

Coloca `gt.config.json` en la raíz de tu proyecto (el directorio de trabajo actual de forma predeterminada; puedes sobrescribirlo con `initialize_gt(..., config_path=...)`). En el archivo, las claves usan **camelCase**. Todas las claves son opcionales; las claves desconocidas se ignoran. Si el archivo predeterminado no existe, se usa una configuración vacía; pero si se proporciona un `config_path` explícito que no existe, se genera `FileNotFoundError`, y si el JSON no es válido, se genera `ValueError`.

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

| Clave                              | Descripción                                                                       | Tipo       | Opcional | Predeterminado |
| ---------------------------------- | --------------------------------------------------------------------------------- | ---------- | -------- | -------------- |
| [`projectId`](#project-id)         | ID del proyecto; habilita el loader de la CDN cuando se configura.                | `string`   | Sí       | —              |
| [`defaultLocale`](#default-locale) | Configuración regional de origen y de respaldo.                                   | `string`   | Sí       | `"en"`         |
| [`locales`](#locales)              | Códigos de configuración regional de destino compatibles.                         | `string[]` | Sí       | —              |
| [`cacheUrl`](#cache-url)           | URL base de la CDN que se usa para cargar traducciones.                           | `string`   | Sí       | —              |
| [`customMapping`](#custom-mapping) | Códigos de configuración regional personalizados y sobrescrituras de propiedades. | `object`   | Sí       | —              |
| [`_versionId`](#version-id)        | Versión de traducción fijada.                                                     | `string`   | Sí       | —              |
| [`runtimeUrl`](#runtime-url)       | URL base de la API de Runtime.                                                    | `string`   | Sí       | —              |

## `projectId` [#project-id]

**Tipo** `string` · **Opcional**

El ID de tu proyecto de General Translation. Cuando se establece (y no se proporciona ningún callback `load_translations`), el SDK carga las traducciones desde la CDN en `{cacheUrl}/{projectId}/{locale}`. Corresponde al argumento `project_id` de `initialize_gt` e `I18nManager`.

## `defaultLocale` [#default-locale]

**Tipo** `string` · **Opcional** · **Predeterminado** `"en"`

La configuración regional de origen en la que está escrito tu contenido y la configuración regional de respaldo cuando no se encuentra ninguna traducción. Si no se establece ni en la configuración ni en la llamada a `initialize_gt`, se usa el valor predeterminado de la biblioteca `"en"` (la constante `LIBRARY_DEFAULT_LOCALE`).

## `locales` [#locales]

**Tipo** `string[]` · **Opcional**

Las configuraciones regionales de destino que se admitirán. La configuración regional predeterminada siempre se incluye en el conjunto de configuraciones regionales del gestor, aunque aquí se omita. La carga anticipada recupera las traducciones de estas configuraciones regionales al inicio.

## `cacheUrl` [#cache-url]

**Tipo** `string` · **Opcional**

La URL base de la CDN que se utiliza para crear las solicitudes de traducción (`{cacheUrl}/{projectId}/{locale}`). La CDN de General Translation es `https://cdn.gtx.dev`.

*Nota: Cuando no se configura `cacheUrl`, el gestor actualmente pasa una URL base vacía al loader remoto en lugar de usar el valor predeterminado de la CDN; configura `cacheUrl` explícitamente para cargar desde la CDN.*

## `customMapping` [#custom-mapping]

**Tipo** `object` · **Opcional**

Un mapeo de códigos de configuración regional personalizados a códigos estándar o a sobrescrituras de propiedades (por ejemplo, `{ "en-US": { "name": "English", "nativeName": "English" } }`). Corresponde al argumento `custom_mapping` y al tipo [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) en `generaltranslation`.

## `_versionId` [#version-id]

**Tipo** `string` · **Opcional**

Una versión de traducción fijada para cargar. Ten en cuenta el guion bajo inicial en la clave del archivo: corresponde al argumento `version_id` de `initialize_gt` e `I18nManager`, y lo devuelve [`get_version_id`](/docs/python/reference/functions/get-version-id).

## `runtimeUrl` [#runtime-url]

**Tipo** `string` · **Opcional**

La URL base de la API de runtime. El loader de configuración interpreta esta clave como `runtime_url`, pero las integraciones actuales de `gt-flask` y `gt-fastapi` no la reenvían al gestor, por lo que no tiene ningún efecto en tiempo de ejecución.

*Nota: `runtimeUrl` se lee, pero las integraciones del framework no la usan.*