# General Translation Platform: コンテキストを生成
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/context/generate-context.mdx
---

title: コンテキストを生成
description: ソースファイルから General Translation プロジェクトの用語集の用語と翻訳指示を生成します。翻訳コンテキストを生成する API リファレンス。

method: POST
---

参照するソースファイルから、プロジェクトレベルの翻訳コンテキスト (用語集の用語と翻訳指示) を生成するバックグラウンドジョブをキューに追加します。必要に応じて、ターゲットロケールごとの用語集を生成することもできます。

## 概要 [#overview]

```http
POST https://api2.gtx.dev/v2/project/setup/generate
```

**権限** `project:context:write` · **レート制限** 中程度 (120/分)

今後の翻訳の指針となるコンテキストを構築します。生成されたジョブを追跡するには、[コンテキスト生成のステータスを取得](/docs/platform/openapi/reference/context/context-status) または [翻訳ジョブのステータスを取得](/docs/platform/openapi/reference/translation/job-status) を使用します。

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

* プロジェクトのデフォルトロケールと同じ方言のターゲットロケールは無視されます。
* `force` が `true` でない限り、プロジェクトにすでにコンテキストがあり、要求されたターゲットロケールのどれにも用語集が必要ない場合、生成はスキップされます。その場合、レスポンスは `{ "status": "completed" }` となり、ジョブはキューに追加されません。
* それ以外の場合は、コンテキスト生成ジョブがキューに追加され、その ID が `status: "queued"` とともに返されます。ターゲットロケールが指定されている場合は、プロジェクトの現在のロケールも更新されます。

## リクエスト [#request]

### ヘッダー

| ヘッダー              | 説明                         | 必須  |
| ----------------- | -------------------------- | --- |
| `x-gt-api-key`    | プロジェクトまたは組織のAPIキー。         | はい  |
| `x-gt-project-id` | プロジェクトID。組織キーを使用する場合に必要です。 | いいえ |

### ボディ

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

| フィールド             | 説明                             | 型          | 任意  | デフォルト   |
| ----------------- | ------------------------------ | ---------- | --- | ------- |
| [`files`](#files) | コンテキストの生成元となるソースファイル。空にはできません。 | `object[]` | いいえ | —       |
| `locales`         | ロケールごとの用語集を生成するためのターゲットロケール。   | `string[]` | はい  | —       |
| `force`           | すでに存在する場合でもコンテキストを再生成します。      | `boolean`  | はい  | `false` |

#### `files` [#files]

**型** `object[]` · **必須**

各要素は1つのソースファイルを参照します。

| Field       | Description          | Type     | Optional | Default |
| ----------- | -------------------- | -------- | -------- | ------- |
| `fileId`    | 不変のファイル識別子。空にはできません。 | `string` | いいえ      | —       |
| `versionId` | バージョン識別子。空にはできません。   | `string` | いいえ      | —       |
| `branchId`  | ファイルが紐付けられているブランチ。   | `string` | はい       | —       |

## レスポンス [#response]

**ステータス** `200 OK`

```json title="Response"
{
  "setupJobId": "job_...",
  "status": "queued"
}
```

生成が不要な場合、レスポンスは代わりに次のようになります:

```json title="Response"
{
  "status": "completed"
}
```

## エラー [#errors]

| ステータス | 原因                                     |
| ----- | -------------------------------------- |
| `400` | リクエストボディが無効、`files` 配列が空、またはロケールが無効です。 |
| `401` | APIキーがないか、無効です。                        |
| `403` | APIキーに `project:context:write` がありません。 |
| `429` | レート制限を超過しました。                          |

## 例 [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/setup/generate \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "fileId": "file_...",
        "versionId": "ver_..."
      }
    ],
    "locales": ["es", "fr"]
  }'
```