# General Translation Platform: Générer le contexte
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/context/generate-context.mdx
---

title: Générer le contexte
description: Générez les termes du glossaire et les instructions de traduction du projet General Translation à partir des fichiers source. Référence d’API pour Generate translation context.

method: POST
---

Met en file d’attente une tâche en arrière-plan qui génère le contexte de traduction au niveau du projet — termes du glossaire et instructions de traduction — à partir des fichiers source que vous référencez. Vous pouvez également générer des glossaires par paramètre régional pour les paramètres régionaux cibles.

## Vue d’ensemble [#overview]

```http
POST https://api2.gtx.dev/v2/project/setup/generate
```

**Permission** `project:context:write` · **Limite de débit** Moyenne (120/min)

Générez le contexte qui guidera les futures traductions. Pour suivre la tâche générée, utilisez [Obtenir l’état de la génération du contexte](/docs/platform/openapi/reference/context/context-status) ou [Obtenir l’état de la tâche de traduction](/docs/platform/openapi/reference/translation/job-status).

## Fonctionnement [#how-it-works]

* Les paramètres régionaux cibles qui correspondent à la même variante que le paramètre régional par défaut du projet sont ignorés.
* Sauf si `force` vaut `true`, la génération est ignorée lorsque le projet dispose déjà d'un contexte et qu'aucun paramètre régional cible demandé ne nécessite de glossaire. Dans ce cas, la réponse est `{ "status": "completed" }` et aucune tâche n'est mise en file d'attente.
* Sinon, une tâche de génération de contexte est mise en file d'attente et son ID est renvoyé avec `status: "queued"`. Lorsque des paramètres régionaux cibles sont fournis, les paramètres régionaux actuels du projet sont également mis à jour.

## Requête [#request]

### En-têtes

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

### Corps

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

| Champ             | Description                                                                    | Type       | Facultatif | Par défaut |
| ----------------- | ------------------------------------------------------------------------------ | ---------- | ---------- | ---------- |
| [`files`](#files) | Fichiers source à partir desquels générer le contexte ; ne peut pas être vide. | `object[]` | Non        | —          |
| `locales`         | Paramètres régionaux cibles pour lesquels générer des glossaires.              | `string[]` | Oui        | —          |
| `force`           | Régénérer le contexte même s’il existe déjà.                                   | `boolean`  | Oui        | `false`    |

#### `files` [#files]

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

Chaque élément fait référence à un fichier source :

| Champ       | Description                                            | Type     | Facultatif | Par défaut |
| ----------- | ------------------------------------------------------ | -------- | ---------- | ---------- |
| `fileId`    | Identifiant stable du fichier ; ne peut pas être vide. | `string` | Non        | —          |
| `versionId` | Identifiant de version ; ne peut pas être vide.        | `string` | Non        | —          |
| `branchId`  | Branche à laquelle le fichier est associé.             | `string` | Oui        | —          |

## Réponse [#response]

**État** `200 OK`

```json title="Response"
{
  "setupJobId": "job_...",
  "status": "queued"
}
```

Lorsque la génération n’est pas nécessaire, la réponse est alors :

```json title="Response"
{
  "status": "completed"
}
```

## Erreurs [#errors]

| État  | Cause                                                                           |
| ----- | ------------------------------------------------------------------------------- |
| `400` | Corps de requête invalide, tableau `files` vide ou paramètre régional invalide. |
| `401` | Clé API manquante ou invalide.                                                  |
| `403` | La clé API ne dispose pas de l’autorisation `project:context:write`.            |
| `429` | Limite de requêtes dépassée.                                                    |

## Exemple [#example]

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