Claves API
Crea, acota y administra claves para la API.
Una clave API autentica las peticiones a la API abierta 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
Pulsa Crear Nueva Clave API
Con la página vacía, el botón dice Crea tu Primera Clave API.
Ponle nombre
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
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
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
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 (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
| 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
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 →
Estadísticas de uso
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
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
| 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
- API abierta — endpoints, forma de la petición y errores
- Importar personajes — para qué sirve la clave del importador
- Reverie Labs — las casillas de API abierta e importación
- Seguridad — el resto de los ajustes de acceso de tu cuenta