# General Translation Platform: Claves de API
URL: https://generaltranslation.com/es/docs/platform/dashboard/reference/api-keys.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Crea y administra claves de API de proyecto y Organization para aplicaciones, desarrollo local y automatización. Referencia de claves de API.

Las claves de API autentican tus aplicaciones, el CLI y tus automatizaciones con General Translation. Usa el alcance de clave más limitado que se ajuste al flujo de trabajo.

## Alcances de las claves [#key-scopes]

General Translation admite dos alcances de API Keys:

* **claves de Organization** para automatización a nivel de Organization. Úsalas para automatización a nivel de la organización o flujos de trabajo que deban operar en varios projects dentro de la Organization.
* **claves de Project** para un solo project. Úsalas en entornos de servidor, desarrollo local y herramientas limitadas al ámbito del project. Nunca las incluyas en bundles desplegados de navegador o de aplicaciones móviles.

En el Dashboard, ambos alcances admiten permisos **All** o **Custom**. **All** otorga todos los permisos que puedes delegar dentro de ese alcance. **Custom** te permite seleccionar un conjunto más reducido; selecciona al menos un permiso. Solo puedes otorgar permisos que tú poseas.

## Crear claves de organización [#create-organization-keys]

Crea claves de organización en **Organization &gt; Developer &gt; Claves de API**. Las claves de organización usan el prefijo `gtx-org-` y pueden configurarse con un conjunto de permisos personalizado.

En estos controles del Dashboard, los permisos se configuran por recurso. `Write` incluye `Read`.

| recurso                        | Lectura                                    | Escritura o habilitado                                                                                      |
| ------------------------------ | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| **Project creation**           | No aplica                                  | Crear nuevos projects en la Organization                                                                    |
| **Claves de API de Project**   | Ver Claves de API de los projects          | Ver, crear y eliminar Claves de API de Project                                                              |
| **Files**                      | Leer archivos y traducciones del project   | Subir contenido de origen y escribir archivos traducidos                                                    |
| **contexto**                   | Leer el contexto de project y Organization | Gestionar grupos de contexto, glosario y prompts personalizados                                             |
| **Organization assets**        | No aplica                                  | Subir y reemplazar recursos, como fuentes, compartidos por todos los projects de la Organization            |
| **Runtime translation**        | No aplica                                  | Traducir contenido on-demand                                                                                |
| **Translation queue**          | No aplica                                  | Encolar trabajos de traducción de archivos para su procesamiento en segundo plano                           |
| **configuración del Proyecto** | No aplica                                  | Actualizar la configuración del project, como la configuración regional predeterminada y la entrega por CDN |

Habilita **Project creation** para la automatización que llama al endpoint [Create a project](/docs/platform/openapi/reference/projects/create-project). Su permiso `org:projects:create` también permite crear projects con la entrega por CDN habilitada; **configuración del Proyecto** (`project:write`) solo es necesaria para modificar la configuración más adelante. Otorga a cada clave solo los permisos que necesite.

Configura **contexto** en **Lectura** o **Escritura** para la automatización que llama a la [Context Management API](/docs/platform/openapi/reference/context-groups/list-context-groups) (`org:context:read` / `org:context:write`). Una clave de organización con este permiso puede actuar sobre todos los grupos de contexto de la Organization. Una [clave de proyecto](#create-project-keys) solo tiene acceso a los grupos asignados a su project y no puede crear, actualizar, eliminar, asignar ni desasignar ningún grupo.

Configura **Organization assets** en **Escritura** para la automatización que sube fuentes para la traducción de Lottie, como la sincronización de [`fonts`](/docs/cli/reference/config#fonts) de la CLI (`org:assets:write`). Las claves de proyecto no pueden subir fuentes.

Configura **Claves de API de Project** en **Escritura** para la automatización que llama a [Create a project Clave de API](/docs/platform/openapi/reference/api-keys/create-project-api-key) o [Delete a project Clave de API](/docs/platform/openapi/reference/api-keys/delete-project-api-key). Con **Lectura** basta para [listar](/docs/platform/openapi/reference/api-keys/list-project-api-keys) u [obtener](/docs/platform/openapi/reference/api-keys/get-project-api-key) las claves de un project; estas operaciones nunca devuelven sus secretos. Para un project de una Organization, usa una clave de esa organización que tenga los permisos requeridos. Las claves de proyecto no pueden listar, crear ni eliminar claves.

Al crear claves mediante la [API HTTP](/docs/platform/openapi/reference/api-keys/create-project-api-key), selecciona los permisos de forma explícita u omite la selección para otorgar todos los permisos de project que puedas delegar. A diferencia de lo que ocurre en los controles del Dashboard, los permisos Escritura otorgados explícitamente mediante HTTP no incluyen Lectura.

## Crear claves de proyecto [#create-project-keys]

Crea claves de proyecto desde **Project &gt; Claves de API**. Las nuevas claves comienzan con `gtx-api-` y funcionan en desarrollo, al preparar y en producción. Sus permisos determinan qué operaciones pueden realizar.

1. Crea una clave e introduce un **Nombre** descriptivo.
2. En **Permisos**, elige **All** o **Custom**.
3. Para **Custom**, selecciona el acceso que necesita cada recurso.
4. Selecciona **Create** y copia de inmediato la clave completa. Guárdala en variables de entorno o en un gestor de secretos.

Las claves de proyecto admiten estos recursos:

| Recurso                        | Lectura                                          | Escritura o habilitado                                                             |
| ------------------------------ | ------------------------------------------------ | ---------------------------------------------------------------------------------- |
| **Files**                      | Leer archivos del Project y traducciones         | Subir contenido de origen y escribir archivos traducidos                           |
| **contexto**                   | Leer los grupos de contexto asignados al Project | Generar contexto, y editar y reordenar los grupos de contexto asignados al Project |
| **Runtime translation**        | No aplicable                                     | Traducir contenido on-demand                                                       |
| **Translation queue**          | No aplicable                                     | Encolar trabajos de traducción de archivos                                         |
| **configuración del Proyecto** | No aplicable                                     | Actualizar la configuración del Project                                            |

Con **contexto**, una clave de proyecto puede llamar a la [Context Management API](/docs/platform/openapi/reference/context-groups/list-context-groups) para los grupos de contexto asignados a su Project. **Lectura** (`project:context:read`) permite listar esos grupos, así como leer y exportar su glosario y sus prompts personalizados. **Escritura** (`project:context:write`) permite además editar e importar ese contenido, reordenar los grupos y generar contexto. Una clave de proyecto no puede crear, actualizar, eliminar, asignar ni desasignar un grupo de contexto; para esas acciones se necesita una clave de organización. Un grupo que no está asignado al Project de la clave devuelve el mismo `403` que un grupo inexistente.

Para la traducción on-demand local, sirve cualquier clave de proyecto con `project:translations:generate`, incluida una clave con acceso total. Para minimizar el riesgo, recomendamos usar una clave aparte con permisos **Custom**: establece **Runtime translation** en **Enabled** y deja los demás recursos en **None**. Para un flujo de traducción de archivos, concede **Files &gt; Escritura** (que incluye Lectura), **Translation queue &gt; Enabled** y **contexto &gt; Escritura**. [`gt translate`](/docs/cli/reference/commands/translate) genera contexto antes de encolar las traducciones, por lo que falla sin **contexto &gt; Escritura**. Si, en cambio, creas la clave mediante la API HTTP o con [`gt api-key create`](/docs/cli/reference/commands/api-key-create), solicita explícitamente `project:files:read`, `project:files:write`, `project:translations:enqueue` y `project:context:write`, ya que en ese caso Escritura no incluye Lectura.

La opción `devApiKey` del SDK y la variable de entorno `GT_DEV_API_KEY` siguen habilitando la traducción en desarrollo y el hot reload. Indica en esa opción una clave de proyecto con permiso de runtime translation. El nombre de la opción no implica que se trate de un tipo de clave distinto.

En la mayoría de los flujos de trabajo con el SDK y la CLI, usa la clave junto con el ID del Project:

```bash
GT_API_KEY=gtx-api-...
GT_PROJECT_ID=...
```

Para acceder a la CLI con tu cuenta, usa [`gt login`](/docs/cli/reference/commands/login). Para crear desde la CLI una clave de proyecto con permisos explícitos, usa [`gt api-key create`](/docs/cli/reference/commands/api-key-create).

## Gestionar claves [#manage-keys]

Usa nombres descriptivos para que las claves sean fáciles de identificar más adelante.

Abre la lista de claves del Project o de la Organization para revisar las claves existentes. La lista de claves muestra:

* **Nombre** y **Clave**, incluida una versión truncada de la clave para identificarla
* **Permisos**, tanto para las claves de proyecto como para las de organización
* **Creada**, cuándo se generó la clave
* **Último uso**, cuándo se usó la clave por última vez

Si tienes permiso para gestionar claves, usa **Editar clave** para renombrar una clave o actualizar sus permisos, y **Eliminar** para revocarla. El secreto completo solo se muestra en el momento de crear la clave.

Revoca las claves que ya no se usen y crea otras nuevas al rotar credenciales. Una clave eliminada suele dejar de autenticar al instante y, en cualquier caso, en un plazo máximo de 10 minutos.

Para rotar una clave de proyecto desde una automatización, [crea](/docs/platform/openapi/reference/api-keys/create-project-api-key) la clave de reemplazo, cambia tu flujo de trabajo para que la use y, después, [elimina](/docs/platform/openapi/reference/api-keys/delete-project-api-key) la clave anterior mediante su ID. Ambas llamadas requieren una clave de organización con **Claves de API de Project** configuradas en **Escritura**.

## Claves de desarrollo existentes [#existing-keys]

Las claves `gtx-dev-` existentes siguen autenticándose como claves de Project. Las claves que tenían el antiguo permiso predeterminado de solo runtime ahora reciben los permisos predeterminados de Project, incluidos files, contexto, Translation queue y Project settings. Los demás conjuntos de permisos personalizados se mantienen sin cambios.

Revisa las claves existentes en **Project &gt; API Keys**. Para el desarrollo local, recomendamos restringirlas a **Runtime translation** o reemplazarlas por nuevas claves de solo runtime. Las claves con acceso completo siguen funcionando, pero el prefix `gtx-dev-` ya no implica permisos limitados. Nunca incluyas estas claves en bundles de cliente desplegados.

## Prácticas de seguridad [#security-practices]

* Nunca hagas commit de claves al control de versiones.
* Nunca incluyas ninguna API key en los bundles de navegador o de aplicaciones móviles desplegados, independientemente de sus permisos. Mantén las credenciales desplegadas en variables de entorno del lado del servidor o en un gestor de secretos.
* Las API keys pueden usarse en código de cliente servido únicamente por tu servidor de desarrollo local. Las claves de Project con acceso completo funcionan, pero recomendamos restringir las claves de desarrollo local a **Runtime translation** (`project:translations:generate`) para minimizar el riesgo.
* Guarda las claves en variables de entorno o en un gestor de secretos.
* Usa claves independientes para desarrollo, preproducción y producción.
* Rota las claves periódicamente.
* Revoca las claves que no uses.
* Elige el nivel de permisos más restringido que funcione para la integración.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
