# General Translation Platform: Создать проект
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/project/create-project.mdx
---

title: Создать проект
description: Создание проекта General Translation с помощью API-ключа организации. Справочник API для создания проекта.

method: POST
---

Создаёт проект в организации, связанной с API-ключом организации. Возвращает ID, имя, ID организации и нормализованную локаль по умолчанию нового проекта.

## Обзор [#overview]

```http
POST https://api2.gtx.dev/v2/projects
```

**Разрешение** `org:projects:create` · **Лимит запросов** По умолчанию (200/мин)

Используйте этот эндпоинт для создания проектов в рамках собственной автоматизации. API-ключи проекта не могут создавать другие проекты.

## Как это работает [#how-it-works]

* Для аутентификации требуется API-ключ организации (`gtx-org-`) с разрешением `org:projects:create`.
* Организация определяется по API-ключу. Не передавайте в запросе ID организации или проекта.
* Имя проекта очищается от пробелов по краям и проверяется. Локаль по умолчанию проверяется и нормализуется: например, `en-us` преобразуется в `en-US`.
* Новый проект наследует список разрешённых локалей и настройки AI-провайдера организации. Существующие участники организации привязываются к нему.
* Если организация достигла лимита проектов, запрос возвращает `409`, не создавая проект.

## Запрос [#request]

### Заголовки

| Заголовок        | Описание                                             | Обязательно |
| ---------------- | ---------------------------------------------------- | ----------- |
| `x-gt-api-key`   | API-ключ организации с правом `org:projects:create`. | Да          |
| `gt-api-version` | Версия API.                                          | Нет         |

Не отправляйте `x-gt-project-id`. Этот эндпоинт определяет организацию по API-ключу и создаёт в ней новый проект.

### Тело запроса

**Тип содержимого** `application/json`

| Поле            | Описание                                                                                                                      | Тип      | Необязательное | По умолчанию |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------- | -------------- | ------------ |
| `name`          | Имя проекта (1–64 символа). Допускаются буквы, цифры, пробелы, дефисы, подчёркивания, апострофы, круглые скобки и точки. | `string` | Нет            | —            |
| `defaultLocale` | Исходная локаль проекта.                                                                                                      | `string` | Нет            | —            |

Неизвестные поля отклоняются.

## Ответ [#response]

**Статус** `201 Created`

| Поле                    | Описание                                   | Тип      |
| ----------------------- | ------------------------------------------ | -------- |
| `project.id`            | ID нового проекта.                         | `string` |
| `project.name`          | Прошедшее проверку имя проекта.            | `string` |
| `project.orgId`         | ID организации, определённый по API-ключу. | `string` |
| `project.defaultLocale` | Нормализованная исходная локаль.           | `string` |

```json title="Response"
{
  "project": {
    "id": "prj_...",
    "name": "Customer Portal",
    "orgId": "org_...",
    "defaultLocale": "en-US"
  }
}
```

## Ошибки [#errors]

| Статус | Причина                                                                                                            |
| ------ | ------------------------------------------------------------------------------------------------------------------ |
| `400`  | Недопустимое тело запроса, имя проекта или локаль по умолчанию.                                                    |
| `401`  | Отсутствует или недействителен API-ключ организации.                                                               |
| `403`  | Ключ не является ключом организации, не имеет разрешения `org:projects:create` или заблокирован политикой доступа. |
| `409`  | Достигнут лимит проектов организации.                                                                              |
| `429`  | Превышен лимит запросов.                                                                                           |
| `500`  | Не удалось создать проект.                                                                                         |

## Пример [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/projects \
  -H "x-gt-api-key: gtx-org-..." \
  -H "gt-api-version: 2026-03-06.v1" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Portal",
    "defaultLocale": "en-US"
  }'
```