Passer au contenu principal
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.
Interface de création de compteur montrant le nom de l’événement, le type d’agrégation et les options de filtrage

​
Ressources API

​
Création d’un compteur

1

Basic Information

​
Meter Name
string
requis
Nom descriptif (par ex. “API Requests”, “Token Usage”)
​
Event Name
string
requis
Nom exact de l’événement à faire correspondre (sensible à la casse). Exemples: api.call, image.generated
2

Aggregation

​
Aggregation Type
string
requis
Choisissez comment les événements sont agrégés :
  • Count: Nombre total d’événements (appels d’API, téléchargements)
  • Sum: Additionne des valeurs numériques (tokens, octets)
  • Max: Valeur la plus élevée sur la période (pic d’utilisateurs)
  • Last: Valeur la plus récente
​
Over Property
string
Clé de métadonnées à agréger (requis pour tous les types sauf Count). Exemples: tokens, bytes, duration_ms
​
Measurement Unit
string
requis
Libellé d’unité pour les factures. Exemples: calls, tokens, GB, hours
3

Filtering (Optional)

Filtrage des événements
Ajoutez des conditions pour filtrer les événements comptés :
  • Logique ET : Toutes les conditions doivent correspondre
  • Logique OU : Toute condition peut correspondre
Comparateurs : égal, différent, supérieur à, inférieur à, contientEnable filtering, choose logic, add conditions with property key, comparator, and value.
4

Create

Vérifiez la configuration et cliquez sur Create Meter.

​
Visualisation des analyses

Analyse des compteurs
Votre tableau de bord des compteurs montre :
  • Aperçu : Utilisation totale et graphique d’utilisation
  • Événements : Événements individuels reçus
  • Clients : Utilisation et frais par client

​
Facturation en crédits plutôt qu’en devise

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.

​
Quand utiliser la déduction basée sur les crédits

ScénarioStandard (devise)Par crédits
Tarification simple par unité (0,01 $/appel)✅ Mieux adaptéSurcharge inutile
Packs de crédits prépayés (achetez 10 000 jetons, utilisez-les au fil du temps)❌ Impossible à exprimer✅ Mieux adapté
Utilisation groupée avec des abonnements (le plan Pro inclut 100 000 appels)Possible via un seuil gratuit✅ Préférable - les crédits se reportent, expirent, s’affichent dans le portail
Produits multi-compteurs partageant une réserve de crédits❌ Chaque compteur facture séparément✅ Tous les compteurs déduisent d’un même solde

​
Configurer un compteur pour déduire des crédits

1

Create a Credit Entitlement

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 :
Configuration du compteur avec l’option Facturer l’utilisation en crédits activée
​
Credit Entitlement
string
requis
Sélectionnez le droit de crédit dont ce compteur doit déduire.
​
Meter units per credit
number
requis
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

​
Comment fonctionne la déduction de crédits

Une fois configuré, le flux de déduction s’exécute automatiquement :
  1. Les événements arrivent - Votre application envoie les événements d’utilisation via l’API d’ingestion d’événements
  2. Le compteur agrège - Les événements sont agrégés selon la configuration du compteur (Count, Sum, Max, Last)
  3. 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
  4. 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)
  5. 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.

​
Plusieurs compteurs, une seule réserve de crédits

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.

​
Dépannage

  • Le nom de l’événement doit correspondre exactement (sensible à la casse)
  • Vérifiez que les filtres du compteur n’excluent pas d’événements
  • Assurez-vous que les identifiants de client existent
  • Désactivez temporairement les filtres pour tester
  • Vérifiez que la propriété Over correspond exactement à la clé des métadonnées
  • Utilisez des nombres, pas des chaînes : tokens: 150 et non "150"
  • Incluez les propriétés requises dans tous les événements
  • Respectez la casse
  • Utilisez les opérateurs adaptés au type de données
  • Assurez-vous que les événements contiennent les propriétés filtrées
  • Consultez l’onglet Événements pour comptabiliser les événements réellement reçus
  • Vérifiez le type d’agrégation (Count vs Sum)
  • Assurez-vous que les valeurs sont numériques pour Sum/Max

​
Prochaines étapes

Send Events

Commencez à envoyer des événements d’utilisation depuis votre application vers vos compteurs.

View Blueprints

Utilisez des configurations de compteurs prêtes à l’emploi pour des cas d’usage courants.