# General Translation Platform: Generar contexto
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/context/generate-context.mdx
---

title: Generar contexto
description: Genera los términos del glosario y las instrucciones de traducción del Project de General Translation a partir de archivos fuente. Referencia de la API de Generate translation context.

method: POST
---

Pone en cola un trabajo en segundo plano que genera el contexto de traducción a nivel de Project —términos del glosario e instrucciones de traducción— a partir de los archivos fuente que indiques. Opcionalmente, genera glosarios por configuración regional para cada configuración regional de destino.

## Resumen [#overview]

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

**Permiso** `project:context:write` · **Límite de tasa** Medio (120/min)

Crea el contexto que guiará las traducciones futuras. Para seguir el trabajo resultante, usa [Obtener el estado de la generación de contexto](/docs/platform/openapi/reference/context/context-status) o [Obtener el estado del trabajo de traducción](/docs/platform/openapi/reference/translation/job-status).

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

* Se ignoran las configuraciones regionales de destino que correspondan al mismo dialecto que la configuración regional predeterminada del Project.
* A menos que `force` sea `true`, se omite la generación cuando el Project ya tiene contexto y ninguna de las configuraciones regionales de destino solicitadas requiere un glosario. En ese caso, la respuesta es `{ "status": "completed" }` y no se pone ningún trabajo en cola.
* En caso contrario, se pone en cola un trabajo de generación de contexto y se devuelve su ID con `status: "queued"`. Cuando se proporcionan configuraciones regionales de destino, también se actualizan las configuraciones regionales actuales del Project.

## Solicitud [#request]

### Cabeceras

| Cabecera          | Descripción                                                         | Obligatorio |
| ----------------- | ------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clave de API de Project o de Organization.                          | Sí          |
| `x-gt-project-id` | ID de Project. 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 generar contexto; no puede estar vacío.                                           | `object[]` | No       | —              |
| `locales`         | Configuraciones regionales de destino para las que se generará un glosario por configuración regional. | `string[]` | Sí       | —              |
| `force`           | Regenera el contexto incluso si ya existe.                                                             | `boolean`  | Sí       | `false`        |

#### `files` [#files]

**Tipo** `object[]` · **Obligatorio**

Cada elemento hace referencia a un archivo fuente:

| Campo       | Descripción                                              | Tipo     | Opcional | Predeterminado |
| ----------- | -------------------------------------------------------- | -------- | -------- | -------------- |
| `fileId`    | Identificador estable del archivo; no puede estar vacío. | `string` | No       | —              |
| `versionId` | Identificador de la versión; no puede estar vacío.       | `string` | No       | —              |
| `branchId`  | Rama a la que está asociado el archivo.                  | `string` | Sí       | —              |

## Respuesta [#response]

**Estado** `200 OK`

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

Cuando no es necesaria la generación, la respuesta es, en cambio:

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

## Errores [#errors]

| Estado | Causa                                                                                     |
| ------ | ----------------------------------------------------------------------------------------- |
| `400`  | Cuerpo de la solicitud no válido, lista `files` vacía o configuración regional no válida. |
| `401`  | Falta la clave de API o no es válida.                                                          |
| `403`  | La clave de API no tiene `project:context:write`.                                              |
| `429`  | Se superó el límite de solicitudes.                                                       |

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