# General Translation Platform: 将文件加入翻译队列
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/translation/queue.mdx
---
title: "将文件加入翻译队列"
description: "将已上传的源文件加入队列，以便在后台进行翻译。每个请求最多 100 个文件。响应结构取决于请求的 gt-api-version。将文件加入翻译队列的 API 参考。"
method: POST
full: true
_openapi:
  method: POST
  route: /v2/project/translations/enqueue
  toc: []
  structuredData:
    headings: []
    contents:
      - content: >
          将已上传的源文件加入队列，以便在后台进行翻译。每个请求最多
          100 个文件。响应结构取决于请求的 `gt-api-version`。
---



## `POST https://api.gtx.dev/v2/project/translations/enqueue`

Enqueue uploaded source files for background translation. Max 100 files per request. The response shape depends on the requested `gt-api-version`.

Authentication: send an API key as a bearer token in the `Authorization: Bearer <key>` header.

### Parameters

- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API version. Defaults to the earliest supported version. Latest is `2026-03-06.v1`.
- `gt-project-id` (header, string, optional): Target project ID. Required when authenticating with an organization API key.

### Request body

Body (`application/json`, object):
- `files` (object[], required)
  - `branchId` (string)
  - `fileId` (string, required)
  - `versionId` (string, required)
  - `fileName` (string)
  - `transformFormat` (string)
- `targetLocales` (string[])
- `sourceLocale` (string)
- `force` (boolean) Default: `false`.
- `modelProvider` ("ANTHROPIC" | "OPENAI" | "XAI" | "GOOGLE"): AI model provider override.
- `publish` (boolean): Publish translations once complete.

### Responses

**200**: Files queued.
Response body (`application/json`, object):
- `jobData` (object): Map of jobId to job details.
- `locales` (string[])
- `message` (string)

**400**: Bad request, including missing source files.
Response body (`application/json`, object):
- `error` (string)
- `missing` (string[])
- `count` (integer)

**401**: Missing or invalid API key.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**403**: The API key lacks the required permission, or the action is not allowed on the current plan.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**429**: Rate limit or quota exceeded.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

The complete OpenAPI 3.1 spec is available at https://generaltranslation.com/openapi.yaml.