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’utilisation 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

Create Meter

Créez des compteurs via l’API.

List Meters

Récupérez tous les compteurs de votre compte.

Get Meter

Obtenez les détails d’un compteur spécifique par son ID.

Archive Meter

Archivez un compteur pour arrêter le suivi d’usage.

Unarchive Meter

Restaurez un compteur archivé pour reprendre le suivi.

Création d’un compteur

1

Basic Information

string
requis
Un nom descriptif pour le compteur (par ex. « API Requests », « Token Usage »).
string
requis
Le nom exact de l’événement à faire correspondre (sensible à la casse). Exemples : api.call, image.generated.
2

Aggregation

string
requis
Choisissez comment les événements sont agrégés :
  • Count : nombre total d’événements (appels API, téléversements)
  • Sum : somme des valeurs numériques (jetons, octets)
  • Max : valeur la plus élevée sur la période (pic d’utilisateurs)
  • Last : valeur la plus récente
string
La clé de métadonnées à agréger (requise pour Sum, Max et Last). Exemples : tokens, bytes, duration_ms.
string
requis
Le libellé de l’unité pour les factures et les rapports. Exemples : calls, tokens, GB, hours.
3

Filtering (Optional)

Interface de filtrage des événements avec logique AND/OR et opérateurs de comparaison
Ajoutez des conditions pour filtrer les événements comptés :
  • Logique ET : Toutes les conditions doivent correspondre
  • Logique OU : Toute condition peut correspondre
Comparateurs disponibles : égal à, différent de, supérieur à, supérieur ou égal à, inférieur à, inférieur ou égal à, contient, ne contient pas.Activez le filtrage, choisissez votre logique, puis ajoutez des conditions avec une clé de propriété, un comparateur et une valeur.
4

Create

Vérifiez votre configuration et cliquez sur Create Meter.

Visualisation des analyses

Tableau de bord d’analyse du compteur affichant une vue d’ensemble de l’utilisation, les événements et les données client
Votre tableau de bord du compteur affiche :
  • Overview : utilisation totale et tendances d’utilisation au fil du temps
  • Events : événements individuels reçus et leurs métadonnées
  • Customers : totaux d’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 configurée). Vous pouvez également configurer un compteur pour déduire l’utilisation du solde de crédits d’un client, afin que l’utilisation consomme des crédits au lieu de générer des frais monétaires.
La déduction basée sur les crédits nécessite un Credit Entitlement associé au même produit. Créez d’abord le credit entitlement, puis associez-le au compteur.

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

Configurer un compteur pour déduire des crédits

1

Create a Credit Entitlement

Commencez par créer un credit entitlement dans Products → Credits. Définissez l’unité (par ex. « API Calls », « Tokens »), la précision et les paramètres du 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 Bill usage in Credits dans la configuration du compteur pour afficher les paramètres des crédits :
Configuration du compteur avec la facturation de l'utilisation en bascule des crédits activée

Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.

string
requis
Sélectionnez le credit entitlement duquel ce compteur déduit les crédits.
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

Free Threshold and Credits

Le Free Threshold s’applique aux compteurs facturés en argent, et non aux compteurs facturés en crédits. Lorsqu’un compteur facture en crédits, chaque unité est comptabilisée pour la déduction de crédits.Exemple : avec un ratio de 1 unité de compteur par crédit, un client qui effectue 2 500 appels API voit 2 500 crédits déduits.

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’Event Ingestion API.
  2. Le compteur agrège — Les événements sont agrégés selon la configuration de votre compteur (Count, Sum, Max, Last).
  3. Le worker en arrière-plan traite — Chaque minute, 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 selon le taux meter_units_per_credit et déduite selon l’ordre FIFO (les attributions dont l’expiration est la plus proche sont consommées en premier).
  5. Le dépassement est suivi — Si le solde atteint zéro, l’utilisation supplémentaire est enregistrée comme un dépassement et traitée selon le comportement configuré (abandonnée lors de la réinitialisation, facturée sur la facture suivante ou reportée comme déficit). Dodo Payments ne bloque pas l’utilisation lorsque le solde est épuisé. Pour arrêter l’accès lorsque le solde atteint zéro, vérifiez le solde dans votre application.
La déduction des crédits s’exécute de manière asynchrone (environ toutes les minutes). Un bref délai peut s’écouler entre l’ingestion de l’événement et la déduction du solde. Concevez votre application pour gérer ce délai et ne vous fiez pas aux vérifications du solde en temps réel pour contrôler l’accès lors de requêtes individuelles.

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

Vous pouvez associer plusieurs compteurs d’un même produit au même credit entitlement. Tous les compteurs déduisent les crédits d’un solde partagé. Exemple : une plateforme d’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 les événements
  • Vérifiez que les identifiants client existent dans votre compte
  • Désactivez temporairement les filtres pour effectuer un test
  • Vérifiez que la propriété Over correspond exactement à la clé de métadonnées
  • Utilisez des nombres, et non des chaînes : tokens: 150 et non tokens: "150"
  • Incluez les propriétés requises dans tous les événements
  • Respectez exactement la casse
  • Utilisez les opérateurs appropriés au type de données
  • Assurez-vous que les événements incluent les propriétés filtrées
  • Consultez l’onglet Events pour compter les événements effectivement reçus
  • Vérifiez le type d’agrégation (Count ou Sum)
  • Assurez-vous que les valeurs sont numériques pour Sum et 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.
Dernière modification le 26 septembre 2026