Transformera råanvändningsevenemang till fakturerbara kvantiteter med aggregering och filtrering.
Mätare omvandlar råa händelser till fakturerbara mängder. De filtrerar händelser och tillämpar aggregeringsfunktioner (Count, Sum, Max, Last) för att beräkna användning per kund.
Enhetsetikett för fakturor. Exempel: calls, tokens, GB, hours
3
Filtering (Optional)
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
Jämförelseoperatorer: lika med, inte lika med, större än, större än eller lika med, mindre än, mindre än eller lika med, innehåller, innehåller inteAktivera filtrering, välj logik, lägg till villkor med egenskapsnyckel, jämförare och värde.
4
Create
Granska konfigurationen och klicka på Create Meter.
Som standard debiterar mätare kunder per enhet i dollar (eller din konfigurerade valuta). Du kan istället konfigurera en mätare för att dra från en kreditbalans – så användning förbrukar krediter istället för att generera en monetär avgift.
Kreditbaserad avräkning kräver en Credit Entitlement kopplad till samma produkt. Skapa din kredit först, sedan länkar du den till mätaren.
Först skapar du en kredit i Products → Credits. Definiera enheten (t.ex. “API Calls”, “Tokens”), precision och livscykelinställningar (utgång, ö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. Det visar kreditinställningarna:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
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
Set the Free Threshold
Den gratströskeln gäller fortfarande – händelser under denna tröskel drar inte krediter.Exempel: Med en gratströskel på 1 000 och mätenheter-per-kredit på 1:
Kunden använder 2 500 API-anrop
Första 1 000 är gratis
Återstående 1 500 drar 1 500 krediter från deras saldo
När det är konfigurerat körs avdragsprocessen automatiskt:
Händelser anländer - Din applikation skickar användningshändelser via Event Ingestion API
Mätaren aggregerar - Händelser aggregeras enligt din mätarkonfiguration (Count, Sum, Max, Last)
Bakgrundsarbetare bearbetar - Varje minut hämtar en arbetare nya händelser sedan senaste kontrollpunkt
Krediter dras - Aggregerad användning konverteras till krediter med meter_units_per_credit och dras med FIFO-ordning (äldsta behörigheter förbrukas först)
Överanvändning spåras - Om balansen når noll och överanvändning är aktiverat fortsätter användningen och överanvändningen hanteras enligt konfigurerat beteende (efterges vid återställning, faktureras vid nästa faktura eller förs vidare som underskott)
Kreditavdrag körs asynkront (ungefär var minut). Det kan vara en kort fördröjning mellan händelseintag och balanseräkning. Designa din applikation för att hantera denna fördröjning – förlita dig inte på realtidskontroller av saldo för åtkomstkontroll vid enskilda förfrågningar.
Du kan koppla flera mätare på samma produkt till samma krediträttighet. Alla mätare drar från ett gemensamt saldo.Exempel: 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.