# Claves API > Crea, acota y administra claves para la API. Source: https://reverie.im/es/docs/integrations/api-keys Language: es Una clave API autentica las peticiones a la [API abierta](https://reverie.im/es/docs/integrations/open-api) de Reverie. Las claves viven en **Ajustes → Más → Claves API**, que es también adonde apunta la casilla **API abierta** de Labs. Cualquier cuenta puede crearlas: no hay requisito de nivel ni tope de cuántas puedes tener. ## Crear una clave \[#create-a-key] ### Pulsa Crear Nueva Clave API \[#press-create-new-api-key] Con la página vacía, el botón dice **Crea tu Primera Clave API**. ### Ponle nombre \[#name-it] El **Nombre** es obligatorio, de 1 a 100 caracteres. Es la etiqueta con la que aparece la clave en la lista y en las estadísticas de uso: "Altavoz del salón", "staging worker". ### Elige Global o un personaje concreto \[#choose-global-or-a-specific-character] **Selección de Personaje** es una elección entre **Global (Todos los Personajes)** y **Personaje Específico**, no un extra opcional. El personaje concreto pasa a ser el personaje fijado de la clave. ### Si quieres, pon tipo de dispositivo y caducidad \[#optionally-set-a-device-type-and-an-expiry] **Tipo de Dispositivo** es texto libre (`speaker`, `phone`, `iot`). **Caducidad** pide una fecha *y* una hora; en ese momento la clave deja de funcionar sola. La clave aparece al instante como `rk_` seguido de 64 caracteres hexadecimales. ## Las claves se pueden volver a ver \[#keys-stay-retrievable] El secreto no se revela una sola vez. La tarjeta de cada clave tiene **Mostrar clave API**, **Ocultar clave API** y **Copiar clave API**, en cualquier momento, mientras la clave exista. > Como el secreto completo se puede leer desde tus ajustes, trata el acceso a la cuenta como acceso a la clave. Guarda la clave en un servidor o en un gestor de secretos, nunca en el control de versiones ni en código del navegador. ## Claves globales y claves fijadas \[#global-keys-and-pinned-keys] | | **Global (Todos los Personajes)** | **Personaje Específico** | | ----------------------- | --------------------------------- | ------------------------------------------------------------------- | | `GET /models` devuelve | Tus personajes recientes | Los escenarios de ese personaje, o el personaje si no tiene ninguno | | `model` omitido | Cae en tu chat más reciente | Usa el personaje fijado | | IDs cortos de escenario | No se resuelven nunca | Se resuelven contra el personaje fijado | ## Desactivar, borrar, rotar \[#disable-delete-rotate] | Acción | Efecto | Reversible | | ---------------------- | --------------------------------------------------------------------- | ---------- | | Interruptor **Activo** | Mientras está apagado, las peticiones con la clave se rechazan | Sí | | **Eliminar** | La clave se destruye y las aplicaciones que la usan pierden el acceso | No | No hay una acción de revocar aparte: desactivar y eliminar son las dos opciones. > Borrar una clave no se puede deshacer, y se lleva con ella su atribución: su tráfico pasado se mueve a un grupo de **Claves eliminadas** en las estadísticas de uso, donde ya no distingues qué integración gastó qué. Desactiva la clave primero si puede que quieras el historial. Para rotar, crea la clave de repuesto, despliégala y luego desactiva o elimina la antigua. No hay rotación automática ni periodo de gracia tras la caducidad: una clave caducada se rechaza con `api_key_expired` en la siguiente petición. ## Permisos \[#scopes] Las claves llevan permisos, y el diálogo de creación no los muestra. Una clave hecha en Ajustes puede llamar a los endpoints de chat, y solo a esos. El endpoint del importador de personajes necesita otro permiso, y la única forma de conseguir una clave así es abrir **Labs → Habilidad de importación de personajes**, que te crea una llamada **Reverie Character Importer (Skill)**. Llamar al importador con una clave normal de ajustes devuelve un 403. [Importar personajes →](https://reverie.im/es/docs/characters/import-characters) ## Estadísticas de uso \[#usage-statistics] El panel **Estadísticas de uso** de esa misma página informa de **Solicitudes**, **Tokens**, **Créditos** y **Claves activas**, agrupados por día UTC, con un desglose por clave bajo **Uso por clave**. Filtra por una clave o por **Todas las claves**, en una ventana de 7 a 90 días —30 por defecto—. Solo se cuentan los chats creados a través de la API. Este panel es el único sitio donde existe el gasto por clave. Tu historial de créditos registra lo que costó cada mensaje, pero no etiqueta la transacción con la clave que la hizo, así que usa estas estadísticas para comparar integraciones. ## Crear una solicitud \[#build-a-request] **Crear una solicitud** abre un generador: eliges una de tus claves activas, eliges un personaje o escenario de la lista que esa clave puede ver, escribes un mensaje, decides streaming y temperatura, y copias cURL, TypeScript o Python que funcionan. La clave se usa en tu navegador solo para cargar la lista de personajes. El código generado lee `REVERIE_API_KEY` del entorno en lugar de llevar el secreto dentro. ## Límites \[#limits] | Límite | Valor | | ------------------------------ | --------------------------------------------------------- | | Claves por cuenta | Sin límite | | Límite de peticiones por clave | Ninguno | | Tope de concurrencia por clave | Ninguno | | Qué acota de verdad el uso | Tu saldo de créditos, más la ventana de modelos gratuitos | ## Relacionado \[#related] * [API abierta](https://reverie.im/es/docs/integrations/open-api) — endpoints, forma de la petición y errores * [Importar personajes](https://reverie.im/es/docs/characters/import-characters) — para qué sirve la clave del importador * [Reverie Labs](https://reverie.im/es/docs/integrations/labs) — las casillas de API abierta e importación * [Seguridad](https://reverie.im/es/docs/account/security) — el resto de los ajustes de acceso de tu cuenta