Résumé d'usage

Affichez la dépense, les tokens et le nombre de requêtes du mois en cours pour un utilisateur, sans construire votre propre comptage.

getUsageSummary() renvoie l'usage du mois en cours pour le couple (app, utilisateur) configuré : vous pouvez donc afficher un « dépensé ce mois-ci » dans votre propre interface sans construire le moindre comptage.

const { spentMicros, totalTokens, requestCount, periodStart, periodEnd } =
  await client.getUsageSummary();

La méthode renvoie un UsageSummary :

La période est un intervalle semi-ouvert [periodStart, periodEnd) en UTC.

const spentEur = spentMicros / 1_000_000;
console.log(`Dépensé ${spentEur.toFixed(2)} € sur ${requestCount} requêtes`);

getUsageSummary() ne lève jamais de 402. Un utilisateur sans usage ce mois-ci lit simplement des zéros, et comme aucune résolution d'identité n'a lieu, un utilisateur non connecté lit des zéros lui aussi.

Portée et fraîcheur

• Cette application seulement. Le résumé couvre le seul couple (app, utilisateur) qu'affirment votre clé et x-fleeex-user, et non tout ce que cet utilisateur a dépensé dans l'ensemble des applications qu'il a connectées. Ce total lui appartient et se consulte dans son compte Fleeex, pas chez vous.
• Un appel passé à l'instant peut ne pas encore être compté. La lecture est à cohérence à terme : ne vous en servez donc pas pour décider si la requête que vous venez d'émettre a été facturée. Le chunk d'usage en streaming ou le bloc usage de la réponse elle-même répondent à cette question. Traitez ce chiffre comme une donnée de tableau de bord, ce pour quoi il est fait.
• Les remboursements ne sont pas déduits ici. spentMicros est ce qui a été facturé au titre de l'usage IA sur la période ; l'argent qui ressort du portefeuille est un mouvement de solde, et non un usage négatif.

Les montants sont hors taxes, comme le portefeuille lui-même. Voir Solde et paiements. Affichez un total de facture destiné à l'utilisateur depuis son compte Fleeex plutôt que de le reconstruire à partir de ce chiffre.