# General Translation Platform: Accoda traduzioni
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/translation/queue.mdx
---

title: Accoda traduzioni
description: Accoda i file sorgente caricati per la traduzione in background in un progetto General Translation. Riferimento API per Accoda traduzioni.

method: POST
---

Accoda job di traduzione in background per file sorgente già caricati. Puoi specificare fino a 100 file e le impostazioni regionali di destinazione in cui tradurli.

## Panoramica [#overview]

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

**Permesso** `project:translations:enqueue` · **Limite di richieste** Elevato (30/min)

Avvia la traduzione in background dei file caricati. Carica prima i file con [Upload source files](/docs/platform/openapi/reference/files/upload-source), quindi monitora lo stato dei job risultanti con [Get translation job status](/docs/platform/openapi/reference/translation/job-status).

## Come funziona [#how-it-works]

* Ogni file sorgente a cui si fa riferimento deve già esistere. Gli eventuali file sorgente mancanti vengono segnalati in una risposta `400` con un elenco `missing` e un `count`.
* Se `branchId` è assente, viene usato il branch predefinito. Imposta `transformFormat` per tradurre un file in un formato di output diverso.
* Quando `targetLocales` viene omesso, vengono utilizzate le impostazioni regionali configurate del progetto. I file già tradotti in una determinata impostazione regionale vengono ignorati, a meno che `force` non sia `true`.
* La struttura della risposta dipende dalla versione dell'API inviata tramite l'header `gt-api-version`. La versione `2025-11-03.v1` e successive restituiscono `jobData` con chiavi per job. Vedi [versioning in the Overview](/docs/platform/openapi/overview#api-basics).

## Richiesta [#request]

### Header

| Header            | Descrizione                                                                          | Obbligatorio |
| ----------------- | ------------------------------------------------------------------------------------ | ------------ |
| `x-gt-api-key`    | Chiave API del progetto o dell'organizzazione.                                   | Sì           |
| `x-gt-project-id` | ID progetto. Obbligatorio quando si utilizza una chiave API dell'organizzazione. | No           |

### Body

**Tipo di contenuto** `application/json`

| Campo             | Descrizione                                      | Tipo       | Facoltativo | Predefinito                                     |
| ----------------- | ------------------------------------------------ | ---------- | ----------- | ----------------------------------------------- |
| [`files`](#files) | File sorgente da tradurre (1–100).               | `object[]` | No          | —                                               |
| `targetLocales`   | Impostazioni regionali in cui tradurre.          | `string[]` | Sì          | Impostazioni regionali del progetto             |
| `sourceLocale`    | Impostazione regionale di origine dei file.      | `string`   | Sì          | Impostazione regionale predefinita del progetto |
| `force`           | Ritraduci i file che hanno già delle traduzioni. | `boolean`  | Sì          | `false`                                         |
| `modelProvider`   | Provider del modello da usare per la traduzione. | `string`   | Sì          | —                                               |
| `publish`         | Pubblica le traduzioni risultanti nella CDN.     | `boolean`  | Sì          | —                                               |

#### `files` [#files]

**Tipo** `object[]` · **Obbligatorio**

Ogni elemento fa riferimento a un file sorgente caricato:

| Campo             | Descrizione                                               | Tipo     | Facoltativo | Predefinito               |
| ----------------- | --------------------------------------------------------- | -------- | ----------- | ------------------------- |
| `fileId`          | Identificatore stabile del file; obbligatorio.            | `string` | No          | —                         |
| `versionId`       | Identificatore della versione; obbligatorio.              | `string` | No          | —                         |
| `branchId`        | Branch a cui è associato il file.                         | `string` | Sì          | Branch predefinito        |
| `fileName`        | Nome del file.                                            | `string` | Sì          | —                         |
| `transformFormat` | Formato del file di output in cui generare la traduzione. | `string` | Sì          | Formato del file sorgente |

## Risposta [#response]

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

## Errori [#errors]

| Stato | Causa                                                                                                                                                |
| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400` | Corpo della richiesta non valido, impostazione regionale non valida o file sorgente di riferimento non trovati (restituiti con `missing` e `count`). |
| `401` | Chiave API mancante o non valida.                                                                                                                    |
| `403` | La chiave API non dispone di `project:translations:enqueue`.                                                                                         |
| `429` | Limite di richieste superato.                                                                                                                        |

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