# 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 claves de API: * **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 para aplicaciones desplegadas, desarrollo local, vistas previas y herramientas limitadas al ámbito del project. claves de Organization y claves de project tienen flujos de creación distintos. Las claves de Project se crean como claves de producción o de desarrollo. Las claves de Organization usan un selector de permisos. ## Crear claves de Organization [#create-organization-keys] Crea claves de Organization en **Organization > Developer > clave de API**. Las claves de Organization usan el prefijo `gtx-org-` y pueden configurarse con un conjunto de permisos personalizado. Los permisos se configuran por recurso. `Write` incluye `Read`. | recurso | Read | Write or enabled | | --------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | | **Project creation** | No aplica | Crear nuevos projects en la Organization | | **clave de API de Project** | Ver claves de API de los projects | Ver y crear claves de API de Project | | **Files** | Leer archivos y traducciones del project | Subir contenido fuente y escribir archivos traducidos | | **contexto** | Leer el contexto de project y Organization | Gestionar grupos de contexto, glosario y prompts personalizados | | **traducción en runtime** | No aplica | Traducir contenido bajo demanda | | **Translation queue** | No aplica | Poner en cola trabajos de traducción de archivos para su procesamiento en segundo plano | | **Project settings** | 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/project/create-project). También habilita **Project settings** cuando esa automatización cree projects con la entrega por CDN habilitada. Otorga a cada clave solo los permisos que necesite. Configura **clave de API de Project** en **Write** para la automatización que llama a [Create a project API Key](/docs/platform/openapi/reference/project/create-api-key). El endpoint acepta un nombre y, opcionalmente, un tipo de clave de producción o desarrollo; no acepta permisos personalizados. La clave creada recibe los valores predeterminados de su tipo, limitados a los permisos de project que posee la identidad de la solicitud. La identidad de la solicitud puede ser una clave de Organization o un token de acceso de usuario de OAuth; las claves de project no pueden tener el permiso requerido `project:api_keys:write`. ## Crear claves de project [#create-project-keys] Crea claves de project desde **Project > clave de API**. Copia la clave completa de inmediato y guárdala en variables de entorno, un gestor de secretos u otro almacenamiento seguro. * Las **claves de producción** comienzan con `gtx-api-`. * Úsalas para subir archivos, trabajos de traducción y automatizaciones de producción. Las claves creadas en el panel de control tienen los permisos predeterminados de project; una clave creada mediante la API de Organization puede tener menos permisos delegados. * Las **claves de desarrollo** comienzan con `gtx-dev-`. * Úsalas para la traducción on-demand durante el desarrollo local. Su permiso predeterminado es la traducción en runtime; los endpoints exclusivos de producción las rechazan. * No uses claves de desarrollo en producción. En la mayoría de los flujos de trabajo del SDK y la CLI, usa la clave con tu ID de project: ```bash GT_API_KEY=gtx-api-... GT_PROJECT_ID=... ``` ## 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 proyecto 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**, para las claves de Organization * **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 los permisos de una clave de Organization, 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. ## Prácticas de seguridad [#security-practices] * Nunca hagas commit de claves al control de versiones. * 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.