# General Translation Platform: 创建项目
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/project/create-project.mdx
---
title: 创建项目
description: 使用 组织 API 密钥 创建 General Translation 项目。创建项目的 API 参考。

method: POST
---

在与 组织 API 密钥 关联的 组织 中创建项目。返回新项目的 ID、名称、组织 ID 以及标准化后的默认区域设置。

## 概览 [#overview]

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

**权限** `org:projects:create` · **速率限制** 默认 (200/分钟) 

使用此端点可通过您自己的自动化流程创建项目。项目 API 密钥无法创建其他项目。

## 工作原理 [#how-it-works]

* 身份验证需要使用具有 `org:projects:create` 权限的 组织 API 密钥 (`gtx-org-`) 。
* 系统会根据 API 密钥 确定 组织。请勿在请求中传入 组织 或项目 ID。
* 系统会修剪并验证项目名称。默认区域设置会经过验证和标准化，例如将 `en-us` 规范为 `en-US`。
* 新项目会继承 组织 的区域设置允许列表和 AI provider 设置，并关联现有的 组织 成员。
* 如果 组织 已达到项目数量上限，请求将返回 `409`，且不会创建项目。

## 请求 [#request]

### 请求头

| 请求头              | 描述                                     | 必填 |
| ---------------- | -------------------------------------- | -- |
| `x-gt-api-key`   | 具有 `org:projects:create` 权限的组织 API 密钥。 | 是  |
| `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`         | 根据 API 密钥确定的组织 ID。 | `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"
  }'
```