Claves de API: autentica REST, CLI, SDK y MCP

Las claves de API autentican tu acceso programático a los datos de LLM Pulse. Úsalas con la CLI nativa de Rust, los SDK oficiales, la REST API, la integración con MCP y el conector de Looker Studio. Disponibles en planes Scale y superiores.

La página Claves de API muestra todas las claves que has creado, su prefijo y la fecha del último uso, y te permite generar claves nuevas o revocar las antiguas.

Qué hace

• Crear claves de API con nombres personalizados para distintos usos
• Mostrar el prefijo y la fecha del último uso para identificarlas
• Las claves empiezan por el prefijo llmpulse_
• Permitir revocar las claves que ya no necesites

Cómo usarla

1. Haz clic en tu nombre/avatar, en la parte inferior izquierda de la barra lateral
2. Haz clic en Claves de API
3. Haz clic en Crear clave de API y dale un nombre descriptivo
4. Copia la clave completa de inmediato; solo se muestra una vez
5. Usa la clave como token Bearer: Authorization: Bearer llmpulse_your_key_here
6. Revoca desde la misma página las claves que ya no necesites

Limitar una clave a algunos proyectos

Al crear una clave, el campo Proyectos define a qué puede acceder. Déjalo vacío (Todos los proyectos) si quieres una clave que vea toda la cuenta, incluidos los proyectos que añadas más adelante, igual que todas las claves creadas antes de que existiera esta opción. Elige uno o varios proyectos para limitar la clave a ellos; por ejemplo, cuando una agencia o un portal de clientes entrega a un cliente una clave para los proyectos de ese cliente.

Una clave limitada a algunos proyectos:

• Solo devuelve esos proyectos al listarlos y trata cualquier otro proyecto como si no existiera (ERR_PROJECT_NOT_FOUND)
• Solo accede a los prompts, respuestas, competidores, etiquetas, webhooks, informes y estudios de esos proyectos
• No puede crear ni eliminar proyectos, ni usar los endpoints de equipo ni los de claves de API: esas solicitudes se rechazan con ERR_KEY_PROJECT_SCOPED (403)

Los proyectos no se pueden cambiar una vez creada la clave. Para dar a un cliente otro conjunto de proyectos, crea una clave nueva y revoca la anterior. Si eliminas un proyecto, se quita de las claves limitadas a él, y cualquier clave que se quede sin proyectos se revoca.

Crear claves a través de la API

Una integración puede crear claves limitadas a algunos proyectos; por ejemplo, una por cada proyecto de cliente que configure. Envía POST /api/v1/api_keys con un name y los project_ids, y la respuesta devuelve la clave nueva, que no se vuelve a mostrar. GET /api/v1/api_keys lista tus claves sin mostrarlas completas, y DELETE /api/v1/api_keys/{id} revoca una.

Solo puede usar estos endpoints una clave que vea toda la cuenta y tenga acceso de lectura y escritura, y las claves que se crean con ellos nunca ven toda la cuenta. Cuando llegues a 500 claves activas, revoca las que ya no uses para poder crear más.

Si cambias de plan

Las claves de API solo funcionan mientras tu cuenta esté en el plan Scale o en uno superior. Si la cuenta pasa a un plan inferior, sus claves siguen apareciendo en la lista y aún puedes revocarlas. Las solicitudes que se hagan con ellas se rechazan con ERR_PLAN_REQUIRED (403), salvo las que te ayudan a hacer limpieza: listar y eliminar suscripciones de webhook (GET /api/v1/webhooks, DELETE /api/v1/webhooks/{id}) y listar y revocar claves de API (GET /api/v1/api_keys, DELETE /api/v1/api_keys/{id}). Las claves vuelven a funcionar con normalidad en cuanto la cuenta regresa al plan Scale o a uno superior. Las conexiones MCP que inician sesión con OAuth no se ven afectadas, porque no usan ninguna clave de API.

Una vez terminada tu suscripción (tres días después de la fecha hasta la que estaba pagada), o si la cuenta nunca ha tenido ninguna, o mientras esté en pausa por una renovación pendiente de pago, todas las solicitudes a la API y todas las conexiones MCP, incluidas las que inician sesión con OAuth, se rechazan con ERR_ACCOUNT_INACTIVE (403), aunque solo sean de lectura. Las solicitudes que ponen en marcha acciones de pago, como nuevas ejecuciones de prompts, tareas de GEO Writer o informes, dejan de aceptarse en cuanto llega la fecha hasta la que estaba pagada o en cuanto la cuenta queda en pausa. Pagar la factura pone fin a la pausa, y volver a suscribirte desde Planes y facturación reactiva una cuenta cuya suscripción ha terminado, en ambos casos con las mismas claves y conexiones.

Consejos y notas

• Disponible en planes Scale y superiores
• Límite de API: 300 solicitudes por minuto y por clave
• Mantén tus claves de API en secreto; nunca las expongas en código del lado del cliente ni en repositorios públicos
• La misma clave funciona con la REST API, la CLI nativa de Rust, los SDK oficiales, MCP sin interfaz y el conector de Looker Studio
• Cada clave tiene un prefijo visible en la lista para identificarla sin mostrar la clave completa