API · Referencia
Gestión de claves
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.
Las claves de API se crean y se revocan en la Developer Console, 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.
Crear una clave
Abra la consola
Vaya a la Developer Console, abra la pestaña API Keys y pulse Create key.
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).
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.
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.
Qué incluye una clave
| Propiedad | Valor |
|---|---|
| Permisos | generate y read; no se pueden elegir; consulte Permisos de la clave |
| Límite de solicitudes | 120 por minuto por clave; consulte Límites de solicitudes |
| 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.
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.
Uso de las claves
La pestaña Logs de la consola muestra las solicitudes por clave. GET /v1/account devuelve un resumen de 30 días de la clave actual, y los clientes de LLM pueden usar GET /v1/key.
Errores
El formato único de errores de la API de Clipia — campos type, code y message, la tabla de estados HTTP y códigos, qué reintentar y cómo leer message.
Clipia AI Gateway
Una única API compatible con OpenAI para Claude, GPT, Gemini, DeepSeek y Grok, que se paga con créditos de Clipia. Obtenga una clave y envíe su primera solicitud en un par de minutos.