Transformieren Sie rohe Nutzungsereignisse in abrechenbare Mengen mit Aggregation und Filterung.
Zähler wandeln Rohereignisse in abrechenbare Mengen um. Sie filtern Ereignisse und wenden Aggregationsfunktionen (Count, Sum, Max, Last) an, um die Nutzung pro Kunde zu berechnen.
Einheitenbezeichnung für Rechnungen. Beispiele: calls, tokens, GB, hours
3
Filtering (Optional)
Fügen Sie Bedingungen hinzu, um zu filtern, welche Ereignisse gezählt werden:
UND-Logik: Alle Bedingungen müssen übereinstimmen
ODER-Logik: Jede Bedingung kann übereinstimmen
Vergleichsoperatoren: gleich, nicht gleich, größer als, größer oder gleich, kleiner als, kleiner oder gleich, enthält, enthält nichtAktivieren Sie Filter, wählen Sie die Logik, und fügen Sie Bedingungen mit Property-Key, Vergleichsoperator und Wert hinzu.
4
Create
Überprüfen Sie die Konfiguration und klicken Sie auf Create Meter.
Standardmäßig berechnen Meter Kunden pro Einheit in Dollar (oder deiner konfigurierten Währung). Du kannst stattdessen ein Meter so konfigurieren, dass es vom Credit-Guthaben abzieht – sodass Nutzung Credits verbraucht statt eine monetäre Gebühr zu erzeugen.
Die kreditbasierte Abrechnung benötigt eine Credit-Berechtigung, die demselben Produkt zugeordnet ist. Lege zuerst deinen Credit an und verknüpfe ihn dann mit dem Meter.
Erstelle zuerst einen Credit unter Products → Credits. Definiere die Einheit (z. B. „API Calls“, „Tokens“), die Genauigkeit und Lebenszyklus-Einstellungen (Ablauf, Übertragung, Überziehung).Sieh dir den Credit-Based Billing guide für detaillierte Anleitungen an.
2
Create or Edit a Usage-Based Product
Gehe zu deinem nutzungsbasierten Produkt und öffne den Konfigurationsbereich Meter.
3
Add a Meter
Klicke auf die +-Schaltfläche, um ein Meter anzufügen. Konfiguriere wie gewohnt den Ereignisnamen, den Aggregationstyp und die Messeinheit.
4
Enable 'Bill Usage in Credits'
Aktiviere Bill usage in Credits in der Meter-Konfiguration. Dadurch werden die Credit-Einstellungen sichtbar:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
Die Anzahl der Nutzungseinheiten, die benötigt werden, um 1 Credit abzuziehen. Beispielsweise:
1 = jedes Meter-Ereignis zieht 1 Credit ab
100 = 100 Meter-Ereignisse ziehen 1 Credit ab
1000 = 1.000 API-Aufrufe verbrauchen 1 Credit
5
Set the Free Threshold
Der kostenlose Schwellenwert gilt weiterhin – Ereignisse unterhalb dieses Schwellenwerts ziehen keine Credits ab.Beispiel: Mit einem kostenlosen Schwellenwert von 1.000 und meter-units-per-credit von 1:
Kunde nutzt 2.500 API-Aufrufe
Die ersten 1.000 sind kostenlos
Die verbleibenden 1.500 ziehen 1.500 Credits vom Guthaben ab
Sobald konfiguriert, läuft die Abzugs-Pipeline automatisch ab:
Ereignisse treffen ein – Deine Anwendung sendet Nutzungsevents über die Event Ingestion API
Meter aggregiert – Ereignisse werden gemäß deiner Meter-Konfiguration aggregiert (Count, Sum, Max, Last)
Hintergrundprozesse – Jede Minute holt ein Worker neue Ereignisse seit dem letzten Checkpoint
Credits werden abgezogen – Aggregierte Nutzung wird mit dem meter_units_per_credit Satz in Credits umgerechnet und nach FIFO-Reihenfolge abgebucht (älteste Grants zuerst)
Überziehungen werden erfasst – Wenn das Guthaben null erreicht und Überziehung aktiviert ist, läuft die Nutzung weiter und die Überziehung wird gemäß dem konfigurierten Verhalten behandelt (bei Reset erlassen, auf der nächsten Rechnung berechnet oder als Defizit vorgetragen)
Die Credit-Abrechnung läuft asynchron (etwa jede Minute). Zwischen Ereigniseinspeisung und Guthabenabzug kann es zu kurzen Verzögerungen kommen. Gestalte deine Anwendung so, dass sie diese Verzögerung berücksichtigt – verlasse dich nicht auf Echtzeit-Guthabenkontrollen für einzelne Anfragen.
Du kannst mehrere Meter desselben Produkts mit derselben Credit-Berechtigung verknüpfen. Alle Meter ziehen von einem gemeinsamen Guthaben ab.Beispiel: Eine KI-Plattform mit zwei Metern:
text.generation – 1 Credit pro 1.000 Tokens
image.generation – 10 Credits pro Bild
Beide ziehen aus dem gleichen „AI Credits“-Pool. Der Kunde sieht ein einheitliches Guthaben in seinem Portal.
Nutze unterschiedliche meter_units_per_credit Sätze pro Meter, um relative Kosten auszudrücken. Teure Operationen (Bildgenerierung) verlangen weniger Meter-Einheiten pro Credit als günstige (Textvervollständigung).
List Customer Ledger
Sieh dir den vollständigen Verlauf der Credit-Abzüge für einen Kunden an.
Get Customer Balance
Prüfe das aktuelle Credit-Guthaben eines Kunden über die API.
