---
title: Gestión de claves
description: Cómo crear y revocar una clave de API en la Developer Console, qué incluye una clave nueva, dónde encontrar su secreto de webhook y cuántas claves puede tener.
icon: KeySquare
---

Las claves de API se crean y se revocan en la [Developer Console](/es/developer), en la pestaña **API Keys**. La clave completa y el secreto de firma de webhooks se muestran **una sola vez**, al crearla: guárdelos de inmediato. Cómo enviar la clave en las solicitudes se explica en [Autenticación](/es/docs/getting-started/authentication).

## Crear una clave

<Steps>
<Step>
### Abra la consola

Vaya a la [Developer Console](/es/developer), abra la pestaña **API Keys** y pulse **Create key**.
</Step>

<Step>
### Indique un nombre y el entorno

El nombre puede tener hasta 100 caracteres; le ayuda a distinguir las claves en la lista y en los registros. El entorno es live (`clipia_live_…`) o de prueba (`clipia_test_…`, consulte [Entorno de pruebas](/es/docs/getting-started/sandbox)).
</Step>

<Step>
### Guarde la clave y el secreto

Copie la clave completa y el **secreto de firma de webhooks**. Cada clave tiene su propio secreto, que se usa para firmar los webhooks de los trabajos enviados con esa clave. Ninguno de los dos se vuelve a mostrar.
</Step>
</Steps>

<Callout type="warn" title="Ha perdido una clave o un secreto">
No se pueden recuperar. Cree una clave nueva, cambie a ella su integración y su manejador de webhooks y, después, revoque la antigua.
</Callout>

## Qué incluye una clave

| Propiedad | Valor |
|-----------|-------|
| Permisos | `generate` y `read`; no se pueden elegir; consulte [Permisos de la clave](/es/docs/getting-started/authentication#scopes) |
| Límite de solicitudes | 120 por minuto por clave; consulte [Límites de solicitudes](/es/docs/api-reference/rate-limits) |
| Concurrencia | ilimitada por defecto |
| Saldo | compartido por todas las claves de la cuenta |

Una cuenta puede tener hasta 20 claves activas. Por encima de ese número, crear una clave devuelve `400` con el mensaje `api_key_limit_reached`.

## Revocar una clave

Pulse **Revoke** junto a la clave en la lista. La revocación surte efecto de inmediato o, como máximo, en un minuto. A partir de entonces, las solicitudes con esa clave reciben `401 invalid_api_key`.

<Callout type="warn" title="La clave es un secreto del lado del servidor">
No incluya nunca la clave en un navegador, una aplicación móvil o un repositorio público. Si una clave se filtra, revóquela de inmediato y cree una nueva.
</Callout>

## Uso de las claves

La pestaña **Logs** de la consola muestra las solicitudes por clave. [`GET /v1/account`](/es/docs/api-reference/account) devuelve un resumen de 30 días de la clave actual, y los clientes de LLM pueden usar [`GET /v1/key`](/es/docs/llm-gateway/account).