# General Translation Platform: 翻訳をキューに登録
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/translation/queue.mdx
---

title: 翻訳をキューに登録
description: アップロード済みのソースファイルを General Translation プロジェクトでバックグラウンド翻訳のキューに登録します。翻訳をキューに登録するための API リファレンス。

method: POST
---

すでにアップロードされているソースファイルに対するバックグラウンド翻訳ジョブをキューに登録します。最大 100 個のファイルと、それらの翻訳先ロケールを指定できます。

## 概要 [#overview]

```http
POST https://api2.gtx.dev/v2/project/translations/enqueue
```

**権限** `project:translations:enqueue` · **レート制限** Heavy (30/min)

アップロード済みファイルのバックグラウンド翻訳を開始します。まず [ソースファイルをアップロード](/docs/platform/openapi/reference/files/upload-source) でファイルをアップロードし、その後 [翻訳ジョブのステータスを取得](/docs/platform/openapi/reference/translation/job-status) で生成されたジョブを追跡できます。

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

* 参照されている各ソースファイルは、あらかじめ存在している必要があります。ソースファイルが見つからない場合は、`missing` リストと `count` を含む `400` レスポンスで報告されます。
* `branchId` がない場合は、デフォルトのブランチに解決されます。ファイルを別の出力ファイル形式に変換して翻訳するには、`transformFormat` を設定します。
* `targetLocales` を省略した場合は、プロジェクトに設定されているロケールが使用されます。`force` が `true` でない限り、すでにそのロケールに翻訳済みのファイルはスキップされます。
* レスポンスの形式は、`gt-api-version` ヘッダーで指定した API バージョンによって異なります。バージョン `2025-11-03.v1` 以降では、job ごとにキー付けされた `jobData` が返されます。[概要 のバージョニング](/docs/platform/openapi/overview#api-basics)を参照してください。

## リクエスト [#request]

### ヘッダー

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

### 本文

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

| フィールド             | 説明                    | 型          | 任意  | デフォルト            |
| ----------------- | --------------------- | ---------- | --- | ---------------- |
| [`files`](#files) | 翻訳するソースファイル (1～100) 。 | `object[]` | いいえ | —                |
| `targetLocales`   | 翻訳先のロケール。             | `string[]` | はい  | プロジェクトのロケール      |
| `sourceLocale`    | ファイルのソースロケール。         | `string`   | はい  | プロジェクトのデフォルトロケール |
| `force`           | すでに翻訳済みのファイルを再翻訳します。  | `boolean`  | はい  | `false`          |
| `modelProvider`   | 翻訳に使用するモデルプロバイダー。     | `string`   | はい  | —                |
| `publish`         | 生成された翻訳を CDN に公開します。  | `boolean`  | はい  | —                |

#### `files` [#files]

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

各要素は、アップロードされた1つのソースファイルを参照します。

| フィールド             | 説明                  | 型        | 任意  | デフォルト     |
| ----------------- | ------------------- | -------- | --- | --------- |
| `fileId`          | 固定のファイル識別子。必須。      | `string` | いいえ | —         |
| `versionId`       | バージョン識別子。必須。        | `string` | いいえ | —         |
| `branchId`        | ファイルが関連付けられているブランチ。 | `string` | はい  | デフォルトブランチ |
| `fileName`        | ファイル名。              | `string` | はい  | —         |
| `transformFormat` | 翻訳後の出力ファイル形式。       | `string` | はい  | ソースファイル形式 |

## レスポンス [#response]

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

```json title="Response"
{
  "jobData": {
    "job_...": {
      "sourceFileId": "sf_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "branchId": "br_...",
      "targetLocale": "es",
      "projectId": "prj_...",
      "force": false
    }
  },
  "locales": ["es", "fr"],
  "message": "Enqueued 2 translation(s)."
}
```

## エラー [#errors]

| ステータス | 原因                                                                         |
| ----- | -------------------------------------------------------------------------- |
| `400` | リクエストボディが無効、ロケールが無効、または参照されたソースファイルが見つかりません (`missing` と `count` が返されます) 。 |
| `401` | API キー がないか、無効です。                                                         |
| `403` | API キー に `project:translations:enqueue` 権限がありません。                         |
| `429` | レート制限を超過しました。                                                              |

## 例 [#example]

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