Clés API : authentifier l’API REST, la CLI, les SDK et le MCP
Les clés API authentifient votre accès programmatique aux données LLM Pulse. Utilisez-les avec l’API REST, la CLI Rust native, les SDK officiels, l’intégration MCP et le connecteur Looker Studio. Disponible à partir du forfait Scale.
La page Clés API liste toutes les clés que vous avez créées, affiche leur préfixe et leur date de dernière utilisation, et vous permet d’en générer de nouvelles ou de révoquer les anciennes.
Fonctionnalités
- Créez des clés API avec un nom personnalisé pour chaque cas d’usage
- Affiche le préfixe et la date de dernière utilisation de chaque clé pour l’identifier
- Les clés commencent par le préfixe
llmpulse_ - Permet de révoquer les clés dont vous n’avez plus besoin
Comment l’utiliser
- Cliquez sur votre nom/avatar en bas à gauche de la barre latérale
- Cliquez sur Clés API
- Cliquez sur Créer une clé API et donnez-lui un nom explicite
- Copiez immédiatement la clé complète : elle ne s’affiche qu’une seule fois
- Utilisez la clé comme jeton Bearer :
Authorization: Bearer llmpulse_your_key_here - Révoquez depuis la même page les clés dont vous n’avez plus besoin
Limiter une clé à certains projets
Lorsque vous créez une clé, le champ Projets définit ce à quoi elle a accès. Laissez-le vide (Tous les projets) pour une clé qui voit l’ensemble du compte, y compris les projets ajoutés plus tard, comme toutes les clés créées avant l’arrivée de cette option. Choisissez un ou plusieurs projets pour limiter la clé à ceux-ci, par exemple quand une agence ou un portail client remet à un client une clé pour ses propres projets.
Une clé limitée à certains projets :
- ne liste que ces projets et traite tout autre projet comme inexistant (
ERR_PROJECT_NOT_FOUND) - n’accède qu’aux prompts, réponses, concurrents, tags, webhooks, rapports et études de ces projets
- ne peut ni créer ni supprimer de projets, ni utiliser les endpoints Équipe ou Clés API : ces requêtes renvoient
ERR_KEY_PROJECT_SCOPED(403)
Les projets ne peuvent plus être modifiés une fois la clé créée. Pour donner à un client un autre ensemble de projets, créez une nouvelle clé et révoquez l’ancienne. Supprimer un projet le retire des clés qui y sont limitées, et une clé qui n’a plus aucun projet est révoquée.
Créer des clés via l’API
Une intégration peut créer des clés limitées à certains projets, par exemple une pour chaque projet client qu’elle configure. Envoyez POST /api/v1/api_keys avec un name et les project_ids : la réponse renvoie la nouvelle clé, une seule fois. GET /api/v1/api_keys liste vos clés sans leur secret, et DELETE /api/v1/api_keys/{id} en révoque une.
Seule une clé qui voit l’ensemble du compte, avec un accès en lecture et en écriture, peut appeler ces endpoints, et ceux-ci ne créent jamais de clé qui voit l’ensemble du compte. Lorsque vous atteignez 500 clés actives, révoquez celles que vous n’utilisez plus pour pouvoir en créer d’autres.
Après un changement de forfait
Les clés API ne fonctionnent que tant que votre compte est sur le forfait Scale ou un forfait supérieur. Si le compte passe à un forfait inférieur, ses clés restent dans la liste et vous pouvez toujours les révoquer. Les requêtes envoyées avec ces clés sont refusées avec ERR_PLAN_REQUIRED (403), sauf celles qui vous aident à faire le ménage : lister et supprimer les abonnements webhook (GET /api/v1/webhooks, DELETE /api/v1/webhooks/{id}), et lister et révoquer les clés API (GET /api/v1/api_keys, DELETE /api/v1/api_keys/{id}). Les clés fonctionnent de nouveau normalement dès que le compte repasse sur Scale ou un forfait supérieur. Les connexions MCP authentifiées par OAuth ne sont pas concernées, car elles n’utilisent pas de clé API.
Une fois votre abonnement terminé (trois jours après la fin de la période payée), pendant que le compte est mis en pause pour un renouvellement impayé, ou si le compte n’a jamais eu d’abonnement, toutes les requêtes API et connexions MCP, OAuth compris, sont refusées avec ERR_ACCOUNT_INACTIVE (403), même en lecture. Les requêtes qui lancent un travail payant, comme de nouvelles exécutions de prompts, des tâches GEO Writer ou des rapports, s’arrêtent dès la date de fin de la période payée ou dès le début de la pause. Payer la facture met fin à la pause, et se réabonner depuis Forfaits et facturation réactive un compte dont l’abonnement est terminé, avec les mêmes clés et connexions.
Conseils et remarques
- Disponible à partir du forfait Scale
- Limite de requêtes de l’API : 300 requêtes par minute et par clé
- Gardez vos clés API secrètes : ne les exposez jamais dans du code côté client ni dans des dépôts publics
- La même clé fonctionne pour l’API REST, la CLI Rust native, les SDK officiels, le MCP headless et le connecteur Looker Studio
- Chaque clé affiche dans la liste un préfixe qui permet de l’identifier sans révéler la clé complète