# General Translation Python SDKs: Конфигурация
URL: https://generaltranslation.com/ru/docs/python/reference/config.mdx
---

title: Конфигурация
description: Настройте Python SDK General Translation через файл gt.config.json. Справочник API по gt.config.json.

---

`gt.config.json` содержит общие настройки проекта General Translation на Python. [`initialize_gt`](/docs/python/reference/functions/initialize-gt) считывает их при запуске (или вы можете передать эти значения в [`I18nManager`](/docs/python/reference/classes/i18n-manager)), а любые переданные именованные аргументы имеют приоритет над значениями из файла. На этой странице описаны все ключи, которые считывает SDK.

*Примечание: Python SDK пока находится в экспериментальной стадии.*

## Обзор [#overview]

Поместите `gt.config.json` в корневой каталог проекта (по умолчанию это текущий рабочий каталог; можно переопределить с помощью `initialize_gt(..., config_path=...)`). В файле используются ключи в формате **camelCase**. Все ключи необязательны; неизвестные ключи игнорируются. Если файл по умолчанию отсутствует, используется пустая конфигурация — но если указан явный `config_path`, который не существует, возникает `FileNotFoundError`, а при некорректном JSON возникает `ValueError`.

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

| Ключ                               | Описание                                                 | Тип        | Необязательно | По умолчанию |
| ---------------------------------- | -------------------------------------------------------- | ---------- | ------------- | ------------ |
| [`projectId`](#project-id)         | ID проекта; при указании включает CDN-загрузчик.         | `string`   | Да            | —            |
| [`defaultLocale`](#default-locale) | Исходная и резервная локаль.                             | `string`   | Да            | `"en"`       |
| [`locales`](#locales)              | Поддерживаемые коды целевых локалей.                     | `string[]` | Да            | —            |
| [`cacheUrl`](#cache-url)           | Базовый URL CDN, используемый для загрузки переводов.    | `string`   | Да            | —            |
| [`customMapping`](#custom-mapping) | Пользовательские коды локалей и переопределения свойств. | `object`   | Да            | —            |
| [`_versionId`](#version-id)        | Фиксированная версия перевода.                           | `string`   | Да            | —            |
| [`runtimeUrl`](#runtime-url)       | Базовый URL Runtime API.                                 | `string`   | Да            | —            |

## `projectId` [#project-id]

**Тип** `string` · **Необязательный**

Идентификатор вашего проекта в General Translation. Если он указан (и callback `load_translations` не передан), SDK загружает переводы из CDN по адресу `{cacheUrl}/{projectId}/{locale}`. Соответствует аргументу `project_id` в `initialize_gt` и `I18nManager`.

## `defaultLocale` [#default-locale]

**Тип** `string` · **Необязательно** · **По умолчанию** `"en"`

Локаль исходного языка, на котором написан ваш контент, а также резервная локаль, используемая, если перевод не найден. Если она не указана ни в конфигурации, ни в вызове `initialize_gt`, используется значение библиотеки по умолчанию `"en"` (константа `LIBRARY_DEFAULT_LOCALE`).

## `locales` [#locales]

**Тип** `string[]` · **Необязательно**

Целевые локали, которые нужно поддерживать. Локаль по умолчанию всегда включается в набор локалей менеджера, даже если здесь она не указана. При предварительной загрузке переводы для этих локалей загружаются при запуске.

## `cacheUrl` [#cache-url]

**Тип** `string` · **Необязательно**

Базовый URL CDN, используемый для формирования запросов на перевод (`{cacheUrl}/{projectId}/{locale}`). CDN General Translation — `https://cdn.gtx.dev`.

*Примечание: если `cacheUrl` не задан, менеджер сейчас передаёт удалённому загрузчику пустой базовый URL вместо использования CDN по умолчанию — для загрузки через CDN явно укажите `cacheUrl`.*

## `customMapping` [#custom-mapping]

**Тип** `object` · **Необязательно**

Сопоставление пользовательских кодов локалей со стандартными кодами или переопределениями свойств (например, `{ "en-US": { "name": "English", "nativeName": "English" } }`). Соответствует аргументу `custom_mapping` и типу [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) в `generaltranslation`.

## `_versionId` [#version-id]

**Тип** `string` · **Необязательный**

Закреплённая версия перевода, которую нужно загрузить. Обратите внимание на начальное подчёркивание в ключе файла: оно соответствует аргументу `version_id` в `initialize_gt` и `I18nManager`, а также возвращается функцией [`get_version_id`](/docs/python/reference/functions/get-version-id).

## `runtimeUrl` [#runtime-url]

**Тип** `string` · **Необязательно**

Базовый URL Runtime API. Загрузчик конфигурации преобразует этот ключ в `runtime_url`, но текущие интеграции `gt-flask` и `gt-fastapi` не передают его в manager, поэтому во время выполнения он ни на что не влияет.

*Примечание: `runtimeUrl` считывается, но не используется интеграциями фреймворков.*