Hoppa till huvudinnehåll
Mätare omvandlar råhändelser till debiterbara kvantiteter. De filtrerar händelser och tillämpar aggregeringsfunktioner (Count, Sum, Max, Last) för att beräkna användning per kund.
Mätarskapande-gränssnitt som visar händelsenamn, aggregeringstyp och filtreringsalternativ

API-resurser

Create Meter

Skapa mätare programmässigt via API.

List Meters

Hämta alla mätare i ditt konto.

Get Meter

Hämta information om en viss mätare med dess ID.

Archive Meter

Arkivera en mätare för att sluta spåra användning.

Unarchive Meter

Återställ en arkiverad mätare för att börja spåra igen.

Skapa en Mätare

1

Basic Information

string
obligatorisk
Ett beskrivande namn för mätaren (t.ex. “API Requests”, “Token Usage”).
string
obligatorisk
Det exakta händelsenamnet som ska matchas (skiftlägeskänsligt). Exempel: api.call, image.generated.
2

Aggregation

string
obligatorisk
Välj hur händelser aggregeras:
  • Count: Totalt antal händelser (API-anrop, uppladdningar)
  • Sum: Summan av numeriska värden (tokens, byte)
  • Max: Högsta värdet under perioden (maximalt antal användare)
  • Last: Senast registrerade värde
string
Metadata-nyckeln som ska aggregeras (krävs för Sum, Max och Last). Exempel: tokens, bytes, duration_ms.
string
obligatorisk
Enhetsetiketten för fakturor och rapporter. Exempel: calls, tokens, GB, hours.
3

Filtering (Optional)

Gränssnitt för händelsefiltrering med AND/OR-logik och jämförelseoperatorer
Lägg till villkor för att filtrera vilka händelser som räknas:
  • OCH-logik: Alla villkor måste matcha
  • ELLER-logik: Vilket som helst villkor kan matcha
Tillgängliga jämförelseoperatorer: är lika med, är inte lika med, större än, större än eller lika med, mindre än, mindre än eller lika med, innehåller, innehåller inte.Aktivera filtrering, välj logik och lägg sedan till villkor med en egenskapsnyckel, jämförelseoperator och ett värde.
4

Create

Granska konfigurationen och klicka på Create Meter.

Visa Analys

Instrumentpanel för mätaranalys som visar användningsöversikt, händelser och kunddata
Instrumentpanelen för mätaren visar:
  • Overview: Total användning och användningstrender över tid
  • Events: Enskilda mottagna händelser och deras metadata
  • Customers: Användningstotaler och avgifter per kund

Fakturering i krediter istället för valuta

Som standard debiterar mätare kunder per enhet i dollar (eller den valuta du har konfigurerat). Du kan i stället konfigurera en mätare så att den drar från kundens kreditsaldo, vilket innebär att användningen förbrukar krediter i stället för att skapa en monetär debitering.
Kreditbaserat avdrag kräver en Credit Entitlement som är kopplad till samma produkt. Skapa kreditförmånen först och koppla den sedan till mätaren.

När du ska använda kreditbaserad avräkning

Konfigurera en mätare för att dra krediter

1

Create a Credit Entitlement

Skapa först en kreditförmån i Products → Credits. Definiera enheten (t.ex. “API Calls”, “Tokens”), precisionen och livscykelinställningarna (förfallodatum, överföring, överanvändning).Se Credit-Based Billing guide för detaljerade instruktioner.
2

Create or Edit a Usage-Based Product

Gå till din användningsbaserade produkt och öppna avsnittet Meter.
3

Add a Meter

Klicka på +-knappen för att fästa en mätare. Konfigurera händelsenamn, aggregeringstyp och mätenhet som vanligt.
4

Enable 'Bill Usage in Credits'

Aktivera Bill usage in Credits i mätarkonfigurationen för att visa kreditinställningarna:
Mätarkonfiguration med faktureringsanvändning i krediter omkopplingsknapp aktiverad

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

string
obligatorisk
Välj vilken kreditförmån den här mätaren ska dra från.
number
obligatorisk
Antalet användningsenheter som krävs för att dra 1 kredit. Till exempel:
  • 1 = varje mätarevenemang drar 1 kredit
  • 100 = 100 mätarevenemang drar 1 kredit
  • 1000 = 1 000 API-anrop förbrukar 1 kredit
5

Free Threshold and Credits

Free Threshold gäller för mätare som debiteras i pengar, inte för mätare som debiteras i krediter. När en mätare debiterar i krediter räknas varje enhet mot kreditavdraget.Example: Med meter-units-per-credit på 1 dras 2 500 krediter från en kund som gör 2 500 API-anrop.

Hur kreditavdrag fungerar

När det är konfigurerat körs avdragsprocessen automatiskt:
  1. Events arrive — Din applikation skickar användningshändelser via Event Ingestion API.
  2. Meter aggregates — Händelser aggregeras enligt mätarkonfigurationen (Count, Sum, Max, Last).
  3. Background worker processes — Varje minut hämtar en worker nya händelser sedan den senaste kontrollpunkten.
  4. Credits are deducted — Aggregerad användning omvandlas till krediter med hjälp av meter_units_per_credit-kursen och dras av enligt FIFO-ordning (anslag med tidigast förfallodatum förbrukas först).
  5. Overage tracked — Om saldot når noll registreras ytterligare användning som överanvändning och hanteras enligt det konfigurerade beteendet (efterskänks vid återställning, debiteras på nästa faktura eller förs vidare som underskott). Dodo Payments blockerar inte användning när saldot tar slut. Om åtkomst ska stoppas vid noll kontrollerar du saldot i din applikation.
Kreditavdrag körs asynkront (ungefär var 1:e minut). Det kan uppstå en kort fördröjning mellan mottagandet av en händelse och avdraget från saldot. Utforma din applikation så att den hanterar denna fördröjning och förlita dig inte på saldokontroller i realtid för åtkomstkontroll av enskilda begäranden.

Flera mätare, en kreditpool

Du kan koppla flera mätare på samma produkt till samma kreditförmån. Alla mätare drar från ett gemensamt saldo. Example: En AI-plattform med två mätare:
  • text.generation — 1 kredit per 1 000 tokens
  • image.generation — 10 krediter per bild
Båda drar från samma “AI Credits”-pool. Kunden ser ett enhetligt saldo i sin portal.
Använd olika meter_units_per_credit-tariffer mellan mätare för att uttrycka relativa kostnader. Dyra operationer (bildgenerering) kostar färre mätenheter per kredit än billiga (textkomplettering).

List Customer Ledger

Visa hela kreditavdragshistoriken för en kund.

Get Customer Balance

Kontrollera en kunds aktuella kreditbalans via API.

Felsökning

  • Händelsenamnet måste matcha exakt (skiftlägeskänsligt)
  • Kontrollera att mätarfiltren inte utesluter händelser
  • Kontrollera att kund-ID:n finns i ditt konto
  • Inaktivera filtren tillfälligt för att testa
  • Kontrollera att Over Property matchar metadata-nyckeln exakt
  • Använd tal, inte strängar: tokens: 150, inte tokens: "150"
  • Inkludera obligatoriska egenskaper i alla händelser
  • Matcha skiftläget exakt
  • Använd korrekta operatorer för datatypen
  • Säkerställ att händelserna innehåller de filtrerade egenskaperna
  • Kontrollera fliken Events för att räkna faktiska mottagna händelser
  • Kontrollera aggregeringstypen (Count eller Sum)
  • Säkerställ att värdena är numeriska för Sum och Max

Nästa steg

Send Events

Börja skicka användningshändelser från din applikation till dina mätare.

View Blueprints

Använd färdiga mätarkonfigurationer för vanliga användningsfall.
Senast ändrad 26 september 2026