# General Translation Platform: Mettre des traductions en file d'attente
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/translation/queue.mdx
---
title: Mettre des traductions en file d'attente
description: Mettre en file d'attente des fichiers sources téléversés pour une traduction en arrière-plan dans un projet General Translation. Référence de l'API pour Mettre des traductions en file d'attente.

method: POST
---

Met en file d'attente des tâches de traduction en arrière-plan pour des fichiers sources déjà téléversés. Vous pouvez spécifier jusqu'à 100 fichiers ainsi que les paramètres régionaux cibles vers lesquels les traduire.

## Vue d’ensemble [#overview]

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

**Permission** `project:translations:enqueue` · **Rate limit** Élevée (30/min)

Lancez la traduction en arrière-plan des fichiers téléversés. Téléversez d’abord les fichiers avec [Téléverser les fichiers source](/docs/platform/openapi/reference/files/upload-source), puis suivez l’état des tâches générées avec [Obtenir l’état de la tâche de traduction](/docs/platform/openapi/reference/translation/job-status).

## Comment ça marche [#how-it-works]

* Chaque fichier source référencé doit déjà exister. Les fichiers source manquants sont signalés dans une réponse `400` avec une liste `missing` et un `count`.
* Si `branchId` est absent, la branche par défaut est utilisée. Définissez `transformFormat` pour traduire un fichier vers un autre format de sortie.
* Lorsque `targetLocales` est omis, les paramètres régionaux configurés du projet sont utilisés. Les fichiers déjà traduits pour un paramètre régional sont ignorés, sauf si `force` vaut `true`.
* La structure de la réponse dépend de la version de l’API envoyée via l’en-tête `gt-api-version`. La version `2025-11-03.v1` et les suivantes renvoient `jobData`, indexé par job. Voir la [gestion des versions dans la vue d’ensemble](/docs/platform/openapi/overview#api-basics).

## Requête [#request]

### En-têtes

| En-tête           | Description                                                               | Obligatoire |
| ----------------- | ------------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clé API de projet ou d’organisation.                                      | Oui         |
| `x-gt-project-id` | ID du projet. Obligatoire lors de l’utilisation d’une clé d’organisation. | Non         |

### Corps

**Type de contenu** `application/json`

| Champ             | Description                                           | Type       | Facultatif | Par défaut                              |
| ----------------- | ----------------------------------------------------- | ---------- | ---------- | --------------------------------------- |
| [`files`](#files) | Fichiers source à traduire (1–100).                   | `object[]` | Non        | —                                       |
| `targetLocales`   | Paramètres régionaux cibles.                          | `string[]` | Oui        | locales du projet                       |
| `sourceLocale`    | Paramètre régional source des fichiers.               | `string`   | Oui        | paramètre régional par défaut du projet |
| `force`           | Retraduire les fichiers qui ont déjà des traductions. | `boolean`  | Oui        | `false`                                 |
| `modelProvider`   | Fournisseur de modèle à utiliser pour la traduction.  | `string`   | Oui        | —                                       |
| `publish`         | Publier les traductions obtenues sur le CDN.          | `boolean`  | Oui        | —                                       |

#### `files` [#files]

**Type** `object[]` · **Obligatoire**

Chaque élément correspond à un fichier source téléversé :

| Champ             | Description                                  | Type     | Facultatif | Par défaut               |
| ----------------- | -------------------------------------------- | -------- | ---------- | ------------------------ |
| `fileId`          | Identifiant de fichier stable ; obligatoire. | `string` | Non        | —                        |
| `versionId`       | Identifiant de version ; obligatoire.        | `string` | Non        | —                        |
| `branchId`        | Branche à laquelle le fichier est rattaché.  | `string` | Oui        | Branche par défaut       |
| `fileName`        | Nom du fichier.                              | `string` | Oui        | —                        |
| `transformFormat` | Format du fichier de sortie cible.           | `string` | Oui        | Format du fichier source |

## Réponse [#response]

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

## Erreurs [#errors]

| État  | Cause                                                                                                                                   |
| ----- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `400` | Corps de requête invalide, paramètre régional invalide ou fichiers sources référencés introuvables (renvoyé avec `missing` et `count`). |
| `401` | Clé API manquante ou invalide.                                                                                                          |
| `403` | La clé API ne dispose pas de `project:translations:enqueue`.                                                                            |
| `429` | Limite de requêtes dépassée.                                                                                                            |

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