Mesurer l'usage par fonctionnalité avec plusieurs pools de crédits
Les vrais produits mesurent plus d'une chose — jetons d'IA, minutes de rendu, exports — et tout regrouper dans une seule réserve de crédits masque le coût et bloque des fonctionnalités sans rapport dès que l'une s'épuise. Voici comment modéliser plusieurs réserves de crédits indépendantes sur une même licence Keyright : la forme d'une réserve, la consommation idempotente par réserve qui échoue en mode fermé de façon isolée, l'ordre de consommation du quota inclus vers la recharge prépayée, les consommations atomiques sur plusieurs réserves pour une opération qui dépense deux compteurs à la fois, et la réconciliation par réserve qui fonctionne encore hors ligne.
La plupart des guides de mesure, y compris notre propre introduction, vous disent de choisir une unité facturable et de la mesurer proprement. Ce conseil est juste et c”est par là que presque tout le monde commence. Puis le produit grandit. L”outil d”IA documentaire qui facturait au document traité rend désormais aussi des PDF, appelle un modèle facturé au jeton et laisse exporter vers une poignée de formats sous un plafond mensuel. Trois choses différentes vous coûtent de l”argent, apportent des valeurs différentes et s”épuisent à des rythmes différents — et une seule réserve de « crédits » ne décrit plus honnêtement aucune d”elles.
Cet article porte sur l”étape suivante : mesurer plusieurs ressources sur une même licence, chacune comme sa propre réserve de crédits, sans que les réserves interfèrent entre elles.
À retenir : quand un produit mesure plus d”une ressource, donnez à chacune sa propre réserve au lieu de tout convertir en crédits génériques. Des réserves séparées gardent le prix honnête, permettent de fixer une cadence de réinitialisation et une politique de dépassement différentes par ressource et — surtout — s”épuisent indépendamment, de sorte qu”une réserve d”exports vide ne bloque jamais un travail de rendu. Le coût est un peu plus de mécanique : des consommations idempotentes par réserve, un ordre de consommation explicite quand les réserves se chevauchent et des consommations atomiques sur plusieurs réserves pour une opération qui dépense deux compteurs à la fois.
Pourquoi une seule réserve de crédits ne suffit pas
Le raccourci tentant est un unique solde de « crédits » abstraits, avec une grille de prix disant qu”un document vaut 1 crédit, une minute de rendu 4 et un export 10. Il s”effondre au contact de vrais clients :
- Le taux de change est une fiction que vous entretenez à jamais. Dès que le coût de votre rendu change, le prix effectif que chaque client paie pour les documents bouge aussi, parce qu”ils partagent une seule réserve. Vous ne pouvez pas retarifer une ressource sans toutes les retarifer.
- L”épuisement est tout ou rien. Un client qui brûle la réserve en rendus ne peut plus exporter un document qu”il a déjà payé pour traiter. Une fonctionnalité qui s”emballe affame toutes les autres.
- Personne ne peut lire sa propre consommation. « Il vous reste 4 000 crédits » ne répond à aucune question que le client se pose vraiment, à savoir « combien de rapports puis-je encore exporter ce mois-ci ? ».
Des réserves séparées corrigent ces trois points. Chaque ressource a son propre solde, sa propre cadence de réinitialisation et sa propre politique de dépassement, et en épuiser une n”a aucun effet sur les autres.
Ce qu”est une réserve
Une réserve est un solde consommable nommé que la licence transporte à côté de ses indicateurs et de ses limites. Trois propriétés la définissent :
- Type. Une réserve de quota se recharge selon une cadence (disons 2 000 minutes de rendu réinitialisées le 1er de chaque mois). Une réserve prépayée est un bloc acheté par le client, persistant jusqu”à être dépensé et ne se rechargeant jamais seul.
- Politique de dépassement. Ce qui se passe à zéro — arrêt net, un petit tampon de courtoisie, ou dépassement mesuré et facturé après coup. Décidez-le par réserve ; un arrêt net sur les exports et du dépassement sur les jetons d”IA est un mélange parfaitement raisonnable.
- Réconciliation. Comment la consommation locale est ajustée contre le solde faisant autorité du serveur, ce qui compte le plus pour les déploiements hors ligne et sur site.
Mesurer contre une réserve nommée
Avec une seule réserve, l”appel du SDK nommait une unité ; avec plusieurs, il nomme la réserve. Tout le reste de la mesure à une réserve tient toujours — compter au point d”étranglement, passer une clé d”idempotence stable et échouer en mode fermé — mais désormais chacune de ces règles s”applique par réserve.
var client = KeyrightClient.Initialize(options);
// At the single point where render minutes are consumed.
var draw = await client.MeterAsync(
pool: "render-minutes",
amount: job.Minutes,
idempotencyKey: job.Id); // stable: a retry never double-charges
if (!draw.Allowed)
{
// This pool is empty. Fail closed — do not render — but say which pool.
ShowTopUpPrompt(pool: "render-minutes", message: draw.Message);
return;
}
RunRenderJob(job); // only runs when a render minute was actually metered
MeterAsync renvoie un MeterResult portant Allowed, un Message lisible et Remaining, pour que vous puissiez afficher une alerte de solde faible sans second appel. Comme pour toute vérification Keyright, une consommation contre une réserve inconnue ou épuisée échoue en mode fermé — Allowed vaut false — si bien que la voie de refus est le comportement par défaut, pas quelque chose que vous devez penser à coder.
L”épuisement indépendant est tout l”intérêt
Parce que la consommation est bornée à une réserve, une réserve vide n”arrête que ses propres opérations. Dans la figure ci-dessus, la réserve d”exports est à zéro, mais un rendu réussit encore, car la consommation de rendu ne touche jamais le solde d”exports. Lisez les soldes directement quand vous devez afficher un état ou alerter tôt :
PoolBalance exports = client.GetBalance("exports");
// ResetsAt is non-null for a quota pool, null for a prepaid block.
if (exports.Remaining == 0)
DisableExportButton(reason: $"Export quota resets {exports.ResetsAt:d}.");
else if (exports.Remaining <= exports.Limit * 0.2)
ShowLowBalanceBanner(exports); // warn at 20% — a surprise is a support ticket
Masquer le bouton d”export relève de l”UX, pas de l”application : la vérification faisant autorité est la consommation MeterAsync au point où l”export est produit. L”alerte fait seulement que le client découvre une réserve vide avant de s”y heurter au milieu d”une tâche.
Ordre de consommation : le quota inclus avant la recharge prépayée
Les réserves deviennent intéressantes quand deux d”entre elles peuvent payer la même opération. Une forme courante : chaque forfait inclut un quota mensuel de minutes de rendu, et les clients peuvent acheter des blocs prépayés pour tout ce qui dépasse. Vous voulez dépenser d”abord les minutes incluses — elles expirent en fin de mois, pas les prépayées — pour que le client ne brûle jamais de l”argent qu”il aurait pu utiliser gratuitement.
Exprimez cela comme un parcours ordonné des réserves candidates :
// Spend the resetting quota first, then fall back to the prepaid block.
static async Task<MeterResult> MeterWithFallbackAsync(
KeyrightClient client, string[] poolsInOrder, long amount, string idempotencyKey)
{
foreach (var pool in poolsInOrder)
{
var draw = await client.MeterAsync(pool, amount, idempotencyKey);
if (draw.Allowed) return draw; // first pool with room wins
}
return MeterResult.Denied("All matching pools exhausted. Top up to continue.");
}
var draw = await MeterWithFallbackAsync(
client,
poolsInOrder: ["render-minutes-included", "render-minutes-prepaid"],
amount: job.Minutes,
idempotencyKey: job.Id);
L”unique idempotencyKey représente l”opération entière, pas une réserve en particulier, donc une tentative refusée ne débite rien et une nouvelle tentative rejoue le résultat réglé quelle que soit la réserve qui a fini par payer. Si vous préférez ne pas porter l”ordre dans le code client, déclarez-le une fois sur le serveur comme un groupe de réserves — un ensemble ordonné que le SDK résout pour vous — et revenez à un simple MeterAsync(pool: "render-minutes", …) qui parcourt inclus-puis-prépayé en coulisses.
Une opération, deux réserves : consommations atomiques sur plusieurs réserves
Le cas difficile est une seule opération logique qui dépense de plus d”une réserve à la fois. Un travail de rendu peut consommer des minutes de rendu et les jetons d”IA que brûle son étape de sous-titrage. Les débiter avec deux appels MeterAsync séparés est un piège : si le premier réussit et le second échoue, vous avez facturé une réserve pour un travail que vous êtes sur le point d”abandonner, et il n”y a aucun moyen propre de rendre ce crédit.
La solution est une consommation multiple tout ou rien. Décrivez chaque réserve que l”opération touche et laissez le SDK toutes les vérifier, les débiter ensemble ou n”en débiter aucune :
var plan = new[]
{
new MeterDraw(pool: "render-minutes", amount: job.Minutes),
new MeterDraw(pool: "ai-tokens", amount: job.CaptionTokens),
};
// Every pool must have room, or nothing is debited.
var result = await client.MeterManyAsync(plan, idempotencyKey: job.Id);
if (!result.Allowed)
{
// ShortfallPool names the first pool that could not cover its draw.
ShowTopUpPrompt(pool: result.ShortfallPool, message: result.Message);
return;
}
RunRenderJob(job); // both pools debited together, under one idempotency key
C”est l”équivalent d”une transaction côté mesure : l”invariant est que les soldes du client et le travail livré ne se contredisent jamais. ShortfallPool vous indique quel compteur a bloqué le travail, de sorte que l”invite de recharge pointe vers la bonne réserve au lieu d”un générique « plus de crédits ».
Réinitialisations, réconciliation et hors ligne
Chaque réserve se réconcilie selon ses propres termes. Une réserve de quota se recharge selon sa cadence ; le serveur réinitialise Remaining à Limit à la limite de période et le SDK le reflète à la réconciliation suivante. Une réserve prépayée ne fait que baisser jusqu”à ce que le client achète un autre bloc.
Pour les déploiements hors ligne, le même mécanisme de blocs signés que la mesure à une réserve s”applique, une fois par réserve. Le serveur émet un solde signé cryptographiquement pour chaque réserve — « cette licence détient 2 000 minutes de rendu et 1 000 000 de jetons d”IA » — que le client vérifie contre sa clé publique embarquée et consomme localement, sans appel réseau par consommation. Quand la machine se reconnecte, elle réconcilie chaque réserve indépendamment : elle rapporte ce qu”elle a consommé, le serveur ajuste chaque solde et réémet des blocs signés neufs. Un client isolé ou sur site peut mesurer plusieurs ressources à la fois sans jamais être en ligne pendant une consommation.
La limite honnête ne change pas par rapport à tout compteur côté client : un attaquant déterminé avec un décompilateur peut tenter de patcher un solde local, donc le décompte faisant autorité reste sur un serveur que vous contrôlez, les blocs signés se réconcilient contre lui et vous rendez le client difficile à patcher — voir protéger vos vérifications de licence. La mesure par réserve hors ligne est une extension de confiance maîtrisée pour un usage déconnecté légitime, pas une garantie contre la falsification.
Le faire avec Keyright
Keyright traite chaque réserve comme une partie de première classe de la licence, à côté des sièges, des indicateurs de fonctionnalité et des limites numériques. Vous déclarez une réserve par ressource mesurée — son type, sa cadence de réinitialisation et sa politique de dépassement —, vous vendez des quotas et des blocs prépayés contre elle, et le SDK (.NET, Node, Python, Java) mesure chaque réserve indépendamment, de façon idempotente et en échouant en mode fermé. Les groupes de réserves vous laissent déclarer l”ordre de consommation une seule fois ; MeterManyAsync garde atomique une opération sur plusieurs réserves ; et les blocs signés par réserve emportent le tout hors ligne, en se réconciliant quand une machine se reconnecte. Comme c”est la même licence qui gère déjà vos essais, vos sièges et vos droits, mesurer plusieurs ressources fait partie de la licence, pas d”un système de facturation boulonné sur le côté.
La Community Edition est gratuite et auto-hébergée, vous pouvez donc modéliser un produit à plusieurs réserves et le câbler de bout en bout avant de vous engager — voyez les tarifs, ou lisez la documentation Keyright pour connaître la surface de mesure exacte. Si la tarification à l”usage par fonctionnalité est centrale pour votre produit, l”aperçu des fonctionnalités détaille réserves, quotas et dépassements.
À retenir : une seule réserve de crédits est le bon modèle pour exactement une ressource mesurée. Dès que vous en mesurez une deuxième, donnez-lui sa propre réserve — solde indépendant, réinitialisation indépendante, épuisement indépendant — et recourez à la consommation ordonnée quand les réserves se chevauchent et à une consommation multiple atomique quand une opération dépense deux compteurs à la fois.
Essayez Nebula.NET
Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.