# General Translation Platform: Poner traducciones en cola
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/translation/queue.mdx
---

title: Poner traducciones en cola
description: Pon en cola archivos fuente cargados para su traducción en segundo plano en un Project de General Translation. Referencia de la API para poner traducciones en cola.

method: POST
---

Pone en cola trabajos de traducción en segundo plano para archivos fuente que ya se cargaron. Especifica hasta 100 archivos y las configuraciones regionales de destino para traducirlos.

## Resumen [#overview]

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

**Permiso** `project:translations:enqueue` · **Límite de solicitudes** Alto (30/min)

Inicia la traducción en segundo plano de los archivos subidos. Primero sube los archivos con [Subir archivos fuente](/docs/platform/openapi/reference/files/upload-source) y luego sigue el estado de los trabajos generados con [Consultar el estado del trabajo de traducción](/docs/platform/openapi/reference/translation/job-status).

## Cómo funciona [#how-it-works]

* Cada archivo fuente referenciado debe existir previamente. Los archivos fuente que falten se informan en una respuesta `400` con una lista `missing` y un `count`.
* Si falta `branchId`, se usa la rama predeterminada. Establece `transformFormat` para traducir un archivo a un formato de salida diferente.
* Cuando se omite `targetLocales`, se usan las configuraciones regionales configuradas en el Project. Los archivos ya traducidos a una configuración regional se omiten, a menos que `force` sea `true`.
* La estructura de la respuesta depende de la versión de la API enviada mediante la cabecera `gt-api-version`. La versión `2025-11-03.v1` y posteriores devuelven `jobData` indexado por trabajo. Consulta el [control de versiones en el Overview](/docs/platform/openapi/overview#api-basics).

## Petición [#request]

### Cabeceras

| Cabecera          | Descripción                                                      | Obligatorio |
| ----------------- | ---------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clave de API de Project u Organization.                          | Sí          |
| `x-gt-project-id` | Project ID. Obligatorio cuando se usa una clave de Organization. | No          |

### Cuerpo

**Tipo de contenido** `application/json`

| Campo             | Descripción                                               | Tipo       | Opcional | Predeterminado                                    |
| ----------------- | --------------------------------------------------------- | ---------- | -------- | ------------------------------------------------- |
| [`files`](#files) | Archivos fuente para traducir (1–100).                    | `object[]` | No       | —                                                 |
| `targetLocales`   | Configuraciones regionales de destino a las que traducir. | `string[]` | Sí       | locales del Project                               |
| `sourceLocale`    | Configuración regional de origen de los archivos.         | `string`   | Sí       | configuración regional predeterminada del Project |
| `force`           | Volver a traducir archivos que ya tienen traducciones.    | `boolean`  | Sí       | `false`                                           |
| `modelProvider`   | Proveedor de modelos que se usará para la traducción.     | `string`   | Sí       | —                                                 |
| `publish`         | Publicar las traducciones resultantes en la CDN.          | `boolean`  | Sí       | —                                                 |

#### `files` [#files]

**Tipo** `object[]` · **obligatorio**

Cada elemento hace referencia a un archivo fuente cargado:

| Campo             | Descripción                                       | Tipo     | Opcional | Predeterminado             |
| ----------------- | ------------------------------------------------- | -------- | -------- | -------------------------- |
| `fileId`          | Identificador estable del archivo; obligatorio.   | `string` | No       | —                          |
| `versionId`       | Identificador de versión; obligatorio.            | `string` | No       | —                          |
| `branchId`        | Rama a la que está asociado el archivo.           | `string` | Sí       | Rama predeterminada        |
| `fileName`        | Nombre del archivo.                               | `string` | Sí       | —                          |
| `transformFormat` | Formato de archivo de salida al que se traducirá. | `string` | Sí       | Formato del archivo fuente |

## Respuesta [#response]

**Estado** `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)."
}
```

## Errores [#errors]

| Estado | Causa                                                                                                                                                       |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | Cuerpo de la solicitud no válido, configuración regional no válida o no se encontraron los archivos fuente indicados (se devuelve con `missing` y `count`). |
| `401`  | Falta la clave de API o no es válida.                                                                                                                            |
| `403`  | La clave de API no tiene `project:translations:enqueue`.                                                                                                         |
| `429`  | Se superó el límite de solicitudes.                                                                                                                         |

## Ejemplo [#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"]
  }'
```