# General Translation Platform: Descripción general
URL: https://generaltranslation.com/es/docs/platform/openapi/overview.mdx
---
title: Descripción general
description: Aprende a usar los endpoints públicos de la API de General Translation y la especificación OpenAPI.

related:
  title: Secciones de referencia
  links:
    - /docs/platform/openapi/reference/files/upload-source
    - /docs/platform/openapi/reference/context/generate-context
    - /docs/platform/openapi/reference/translation/translate-runtime
    - /docs/platform/openapi/reference/project/project-info
---

Usa la API de General Translation para crear flujos de trabajo de automatización personalizados.

El SDK y la CLI gestionan la mayoría de las llamadas a la API por ti. Llama a la API directamente cuando necesites cargar archivos, poner en cola trabajos de traducción, descargar traducciones, gestionar ramas y etiquetas, o consultar el estado del proyecto y de los trabajos desde tu propio sistema.

La especificación OpenAPI define estos endpoints en un formato legible por máquinas.

## Conceptos básicos de la API [#api-basics]

### URLs base

* Usa `https://api2.gtx.dev` para los endpoints de proyectos y archivos.
* Usa `https://runtime2.gtx.dev` para la traducción en runtime, incluido `POST /v2/translate`.

### Autenticación

Envía tu clave de API en la cabecera `x-gt-api-key`.

```bash
curl https://api2.gtx.dev/v2/project/info/PROJECT_ID \
  -H "x-gt-api-key: gtx-api-..."
```

Usa el tipo de clave correcto:

* **proyecto (desarrollo)** con el prefijo `gtx-dev-`: para uso local y de vista previa; los endpoints exclusivos de producción la rechazan
* **proyecto (producción)** con el prefijo `gtx-api-`: vinculada a un solo proyecto
* **Organization** con el prefijo `gtx-org-`: funciona en todos los proyectos. Al usar una clave de Organization en endpoints con scope de proyecto, debes enviar `x-gt-project-id`.

Consulta [API keys](/docs/platform/dashboard/reference/api-keys) para saber cómo crear claves de API y definir su scope.

### Permisos

Cada endpoint requiere un permiso en la clave de API. Las Organization keys configuran los permisos explícitamente. Las claves de proyecto usan los valores predeterminados del proyecto.

Permisos comunes:

* `project:files:read` para descargar archivos y leer información de archivos, el estado de la traducción, información de la branch, archivos orphaned, información del proyecto e información del trabajo.
* `project:files:write` para subir archivos, traducciones y diffs; publicar; crear rama y etiqueta; y mover archivos.
* `project:translations:enqueue` para poner archivos en cola para su traducción.
* `project:translations:generate` para traducción en runtime.
* `project:context:read` para leer el estado de generación de context.
* `project:context:write` para generar context.
* `project:write` para actualizar la configuración del proyecto.

### Control de versiones

Envía la cabecera opcional `gt-api-version` para fijar el formato de la respuesta.

```bash
-H "gt-api-version: 2026-03-06.v1"
```

Si omites la cabecera, se usará la versión compatible más antigua. La versión más reciente es `2026-03-06.v1`.

### Límites de tasa

Las solicitudes están sujetas a límites de tasa por API Key o IP del cliente en una ventana de 60 segundos. Los límites varían según el endpoint:

* **Heavy:** 30 solicitudes/minuto para poner traducciones en cola.
* **Medium:** 120 solicitudes/minuto para cargas, diffs, contexto, movimientos y archivos huérfanos.
* **Light:** 300 solicitudes/minuto para descargas de archivos.
* **Default:** 200 solicitudes/minuto para publicación, ramas, etiquetas, información del proyecto, información del trabajo, información del archivo, estado de la traducción y traducción en runtime.

Superar un límite devuelve `429`. Las cuotas de tokens de Organization devuelven `402` desde `POST /v2/translate`.

### Errores

Los errores devuelven un mensaje de `error`. A partir de la versión de la API `2026-02-18.v1`, el cuerpo es JSON; las versiones anteriores, incluida la predeterminada que se usa cuando no se envía la cabecera `gt-api-version`, devuelven el mensaje como texto sin formato.

```json
{
  "error": "API key is missing required permission: project:files:write"
}
```

Códigos de estado comunes:

* `400` para un cuerpo de la solicitud, `query` o versión no válidos.
* `401` para una clave de API ausente o no válida.
* `402` cuando se excede la cuota de tokens de Organization (`POST /v2/translate`).
* `403` cuando la clave de API no tiene permiso o la acción no está permitida en el plan actual.
* `404` cuando no se encuentra el recurso.
* `429` cuando se excede un límite de solicitudes.

## Especificación OpenAPI [#openapi-spec]

Hay una especificación OpenAPI 3.1 legible por máquina disponible en [`/openapi.yaml`](/openapi.yaml). Impórtala en Postman, Insomnia o en un cliente OpenAPI para generar solicitudes y tipos.
## Secciones de referencia

- /docs/platform/openapi/reference/files/upload-source
- /docs/platform/openapi/reference/context/generate-context
- /docs/platform/openapi/reference/translation/translate-runtime
- /docs/platform/openapi/reference/project/project-info