Chaque clé d’API et chaque connexion d’assistant a un plafond de dépense quotidien en crédits. Pour une nouvelle connexion, il est de 5 000 crédits par défaut.

Vous pouvez ajouter deux autres limites à une clé ou une connexion :

  • un plafond mensuel, sur le mois civil (UTC) ;
  • un plafond par question, le maximum que peut coûter une seule question.

Ce qui se passe au plafond

Une question qui ferait dépasser à la connexion l’un de ses plafonds est refusée : l’API répond 402 avec spend_cap_reached (le serveur MCP le signale comme spend_cap_exceeded). L’erreur indique ce qui reste et, pour les plafonds quotidien et mensuel, quand ils se réinitialisent. Rien n’est dépensé. La lecture des résultats continue de fonctionner. Une question annulée ou remboursée rend ses crédits au plafond.

Vérifier ce qui reste

La consultation de solde de votre assistant et GET /v1/billing/balance renvoient capRemaining pour la clé ou la connexion utilisée : le plus petit entre ce qui reste aujourd’hui et ce mois-ci. Un agent bien conçu vérifie avant de demander, mais le plafond s’applique qu’il vérifie ou non. GET /v1/connections/current montre les plafonds de la connexion et ce qu’elle a dépensé aujourd’hui et ce mois-ci.

Modifier un plafond

Dans Développeurs, ouvrez Portées et plafonds sur une clé ou Plafonds et portées sur une connexion et fixez de nouveaux plafonds. Le changement prend effet immédiatement.

Dans une équipe, le propriétaire ou un admin peut changer le plafond d’une clé ou d’une app créée par un autre membre. Ouvrez Clés et apps dans Équipe ou, pour une connexion Zapier, Réglages, puis Intégrations. Voir Votre équipe.

Les anciennes clés, d’avant les plafonds, n’en ont aucun. Elles figurent dans Développeurs sous Anciennes clés pour que vous puissiez les révoquer, et nous les retirerons après un préavis de 90 jours. Créez plutôt une nouvelle clé avec un plafond.

Alertes

Sous Développeurs, Alertes, vous choisissez lesquels de ces e-mails vous voulez. Ils vont à l’adresse e-mail de votre compte, et chacun contient un lien de désabonnement qui désactive uniquement cette alerte.

  • Une connexion atteint 80 % de son plafond quotidien (ou de son plafond mensuel, si elle en a un).
  • Les erreurs augmentent brusquement : une connexion a eu hier au moins 50 appels et plus d’un cinquième ont échoué.
  • Un nouvel agent se connecte.

Les alertes sont dans Développeurs, pas dans Réglages, puis E-mails.

Limites du compte

Les plafonds des clés s’inscrivent dans les limites de votre compte : un agent ne peut jamais dépenser plus que votre solde. Pour une clé ou une connexion créée pour une équipe, les demandes dépensent les crédits de l’équipe, et la limite mensuelle du membre dans l’équipe s’applique aussi.