Transformez les événements d’utilisation bruts en quantités facturables grâce à l’agrégation et au filtrage.
Les compteurs convertissent les événements bruts en quantités facturables. Ils filtrent les événements et appliquent des fonctions d’agrégation (Count, Sum, Max, Last) pour calculer l’usage par client.
Libellé d’unité pour les factures. Exemples: calls, tokens, GB, hours
3
Filtering (Optional)
Ajoutez des conditions pour filtrer les événements comptés :
Logique ET : Toutes les conditions doivent correspondre
Logique OU : Toute condition peut correspondre
Opérateurs de comparaison : égal à, différent de, supérieur à, supérieur ou égal à, inférieur à, inférieur ou égal à, contient, ne contient pasEnable filtering, choose logic, add conditions with property key, comparator, and value.
4
Create
Vérifiez la configuration et cliquez sur Create Meter.
Par défaut, les compteurs facturent les clients à l’unité en dollars (ou dans la devise que vous avez configurée). Vous pouvez plutôt configurer un compteur pour déduire d’un solde de crédits : l’utilisation consomme des crédits plutôt que de générer une charge monétaire.
La déduction basée sur les crédits nécessite un Droit de crédit attaché au même produit. Créez d’abord votre crédit, puis associez-le au compteur.
Commencez par créer un crédit dans Produits → Crédits. Définissez l’unité (par exemple, « Appels API », « Jetons »), la précision et les paramètres de cycle de vie (expiration, report, dépassement).Consultez le guide de facturation basée sur les crédits pour des instructions détaillées.
2
Create or Edit a Usage-Based Product
Accédez à votre produit basé sur l’utilisation et ouvrez la section de configuration du compteur.
3
Add a Meter
Cliquez sur le bouton + pour joindre un compteur. Configurez comme d’habitude le nom de l’événement, le type d’agrégation et l’unité de mesure.
4
Enable 'Bill Usage in Credits'
Activez Facturer l’utilisation en crédits dans la configuration du compteur. Cela affiche les paramètres de crédit :
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
Le nombre d’unités d’utilisation requis pour déduire 1 crédit. Par exemple :
1 = chaque événement de compteur déduit 1 crédit
100 = 100 événements de compteur déduisent 1 crédit
1000 = 1 000 appels API consomment 1 crédit
5
Set the Free Threshold
Le seuil gratuit s’applique toujours : les événements en dessous de ce seuil ne déduisent pas de crédits.Exemple : avec un seuil gratuit de 1 000 et 1 unité de compteur par crédit :
Le client utilise 2 500 appels API
Les 1 000 premiers sont gratuits
Les 1 500 restants déduisent 1 500 crédits de leur solde
Une fois configuré, le flux de déduction s’exécute automatiquement :
Les événements arrivent - Votre application envoie les événements d’utilisation via l’API d’ingestion d’événements
Le compteur agrège - Les événements sont agrégés selon la configuration du compteur (Count, Sum, Max, Last)
Les workers d’arrière-plan traitent - Toutes les minutes, un worker récupère les nouveaux événements depuis le dernier point de contrôle
Les crédits sont déduits - L’utilisation agrégée est convertie en crédits en utilisant le taux meter_units_per_credit et déduite selon l’ordre FIFO (les droits les plus anciens sont consommés en premier)
Le dépassement est suivi - Si le solde atteint zéro et que le dépassement est activé, l’utilisation continue et le dépassement est géré selon le comportement configuré (réinitialisé, facturé sur la prochaine facture, ou reporté comme déficit)
La déduction des crédits s’exécute de manière asynchrone (toutes les ~1 minute). Un léger délai peut exister entre l’ingestion de l’événement et la déduction du solde. Concevez votre application pour gérer ce délai : ne comptez pas sur des vérifications de solde en temps réel pour contrôler l’accès sur des requêtes individuelles.
Vous pouvez lier plusieurs compteurs d’un même produit au même droit de crédit. Tous les compteurs déduisent d’un solde partagé unique.Exemple : une plateforme IA avec deux compteurs :
text.generation - 1 crédit pour 1 000 jetons
image.generation - 10 crédits par image
Les deux déduisent de la même réserve « Crédits IA ». Le client voit un solde unifié dans son portail.
Utilisez des taux meter_units_per_credit différents selon les compteurs pour exprimer des coûts relatifs. Les opérations coûteuses (génération d’images) consomment moins d’unités de compteur par crédit que les opérations bon marché (complétion de texte).
List Customer Ledger
Affichez l’historique complet de déduction de crédits d’un client.
Get Customer Balance
Vérifiez le solde de crédits actuel d’un client via l’API.
