# General Translation Platform: プロジェクトを作成
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/project/create-project.mdx
---
title: プロジェクトを作成
description: Organization API キーを使用して General Translation プロジェクトを作成します。プロジェクト作成の API リファレンス。

method: POST
---

Organization API キーに関連付けられた Organization にプロジェクトを作成します。新しいプロジェクトの ID、名前、Organization ID、正規化されたデフォルトロケールを返します。

## 概要 [#overview]

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

**権限** `org:projects:create` · **レート制限** デフォルト (200/分) 

このエンドポイントを使用すると、独自の自動化からプロジェクトを作成できます。プロジェクト API キーで他のプロジェクトを作成することはできません。

## 仕組み [#how-it-works]

* 認証には、`org:projects:create` 権限を持つ Organization API キー (`gtx-org-`) が必要です。
* Organization は API キー から特定されます。リクエストで Organization または プロジェクト ID を送信しないでください。
* プロジェクト名は前後の空白が削除され、検証されます。デフォルトロケールは検証・正規化され、たとえば `en-us` は `en-US` になります。
* 新しいプロジェクトは、Organization の許可ロケールリストと AI provider 設定を継承します。既存の Organization メンバーはこのプロジェクトに関連付けられます。
* Organization がプロジェクト数の上限に達している場合、プロジェクトは作成されず、リクエストは `409` を返します。

## リクエスト [#request]

### ヘッダー

| ヘッダー             | 説明                                               | 必須  |
| ---------------- | ------------------------------------------------ | --- |
| `x-gt-api-key`   | `org:projects:create` 権限を持つOrganization API キー。 | はい  |
| `gt-api-version` | APIバージョン。                                        | いいえ |

`x-gt-project-id` は送信しないでください。このエンドポイントでは、API キーからOrganizationを特定し、その中に新しいプロジェクトを作成します。

### 本文

**コンテンツタイプ** `application/json`

| フィールド           | 説明                                                                | 型        | 任意  | デフォルト |
| --------------- | ----------------------------------------------------------------- | -------- | --- | ----- |
| `name`          | プロジェクト名 (1～64文字) 。英字、数字、スペース、ハイフン、アンダースコア、アポストロフィ、括弧、ピリオドを使用できます。 | `string` | いいえ | —     |
| `defaultLocale` | プロジェクトのソースロケール。                                                   | `string` | いいえ | —     |

不明なフィールドは受け付けられません。

## レスポンス [#response]

**ステータス** `201 Created`

| フィールド                   | 説明                  | 型        |
| ----------------------- | ------------------- | -------- |
| `project.id`            | 新しいプロジェクト ID。       | `string` |
| `project.name`          | 検証済みのプロジェクト名。       | `string` |
| `project.orgId`         | API キーから導出されたOrganization ID。 | `string` |
| `project.defaultLocale` | 正規化されたソースロケール。      | `string` |

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

## エラー [#errors]

| ステータス | 原因                                                                               |
| ----- | -------------------------------------------------------------------------------- |
| `400` | リクエストボディ、プロジェクト名、またはデフォルトロケールが無効です。                                              |
| `401` | Organization API キー がないか、無効です。                                                  |
| `403` | キーが Organization key ではない、`org:projects:create` 権限がない、またはアクセスポリシーによってブロックされています。 |
| `409` | Organization がプロジェクトの上限に達しています。                                                  |
| `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"
  }'
```