Zum Hauptinhalt springen
Meter wandeln Rohereignisse in abrechenbare Mengen um. Sie filtern Ereignisse und wenden Aggregationsfunktionen (Count, Sum, Max, Last) an, um die Nutzung pro Kunde zu berechnen.
Zählererstellungs-Interface mit Ereignisnamen, Aggregationstyp und Filteroptionen

API-Ressourcen

Create Meter

Erstellen Sie Zähler programmatisch über die API.

List Meters

Rufen Sie alle Zähler in Ihrem Konto ab.

Get Meter

Holen Sie Details für einen bestimmten Zähler anhand der ID.

Archive Meter

Archivieren Sie einen Zähler, um die Nachverfolgung der Nutzung zu stoppen.

Unarchive Meter

Stellen Sie einen archivierten Zähler wieder her, um die Nachverfolgung fortzusetzen.

Einen Zähler erstellen

1

Basic Information

string
erforderlich
Ein beschreibender Name für den Meter (z. B. “API Requests”, “Token Usage”).
string
erforderlich
Der genaue Name des Ereignisses, nach dem gesucht werden soll (Groß-/Kleinschreibung wird berücksichtigt). Beispiele: api.call, image.generated.
2

Aggregation

string
erforderlich
Wählen Sie aus, wie Ereignisse aggregiert werden:
  • Count: Gesamtanzahl der Ereignisse (API-Aufrufe, Uploads)
  • Sum: Summe numerischer Werte (Token, Bytes)
  • Max: Höchster Wert im Zeitraum (Spitzenwert der Nutzer)
  • Last: Zuletzt erfasster Wert
string
Der zu aggregierende Metadatenschlüssel (erforderlich für Sum, Max und Last). Beispiele: tokens, bytes, duration_ms.
string
erforderlich
Die Einheit, die auf Rechnungen und in Berichten angezeigt wird. Beispiele: calls, tokens, GB, hours.
3

Filtering (Optional)

Oberfläche zur Ereignisfilterung mit AND/OR-Logik und Vergleichsoperatoren
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
Verfügbare Vergleichsoperatoren: gleich, nicht gleich, größer als, größer oder gleich, kleiner als, kleiner oder gleich, enthält, enthält nicht.Aktivieren Sie die Filterung, wählen Sie Ihre Logik aus und fügen Sie anschließend Bedingungen mit einem Eigenschaftsschlüssel, einem Vergleichsoperator und einem Wert hinzu.
4

Create

Überprüfen Sie Ihre Konfiguration und klicken Sie auf Create Meter.

Analysen anzeigen

Meter-Analyse-Dashboard mit Nutzungsübersicht, Ereignissen und Kundendaten
Ihr Meter-Dashboard zeigt:
  • Overview: Gesamtnutzung und Nutzungstrends im Zeitverlauf
  • Events: Einzelne empfangene Ereignisse und deren Metadaten
  • Customers: Nutzungs- und Gebührenübersichten pro Kunde

Abrechnung in Credits statt Währung

Standardmäßig werden Kunden für jeden verbrauchten Einheit in Dollar (oder der konfigurierten Währung) belastet. Sie können einen Meter stattdessen so konfigurieren, dass er das Guthaben eines Kunden reduziert. Dadurch verbraucht die Nutzung Credits, anstatt eine Geldbelastung zu erzeugen.
Die creditbasierte Abbuchung erfordert ein Credit Entitlement, das demselben Produkt zugeordnet ist. Erstellen Sie zuerst das Credit Entitlement und verknüpfen Sie es anschließend mit dem Meter.

Wann man kreditbasierte Abrechnung verwenden sollte

Konfiguration eines Meters für Credit-Abzug

1

Create a Credit Entitlement

Erstellen Sie zunächst ein Credit Entitlement unter Products → Credits. Definieren Sie die Einheit (z. B. “API Calls”, “Tokens”), die Genauigkeit und die Lifecycle-Einstellungen (Ablauf, Übertragung, Mehrverbrauch).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'

Aktivieren Sie Bill usage in Credits in der Meter-Konfiguration, um die Credit-Einstellungen anzuzeigen:
Zählerkonfiguration mit aktiviertem Umschalter für die Nutzung von Credits

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

string
erforderlich
Wählen Sie aus, von welchem Credit Entitlement dieser Meter Credits abzieht.
number
erforderlich
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

Free Threshold and Credits

Der Free Threshold gilt für Meter, die in Geld abgerechnet werden, nicht für Meter, die in Credits abgerechnet werden. Wenn ein Meter in Credits abrechnet, zählt jede Einheit für den Credit-Abzug.Beispiel: Bei meter-units-per-credit von 1 werden einem Kunden, der 2.500 API-Aufrufe tätigt, 2.500 Credits abgezogen.

So funktioniert die Credit-Abrechnung

Sobald konfiguriert, läuft die Abzugs-Pipeline automatisch ab:
  1. Ereignisse gehen ein — Ihre Anwendung sendet Nutzungsereignisse über die Event Ingestion API.
  2. Meter aggregiert — Ereignisse werden gemäß Ihrer Meter-Konfiguration aggregiert (Count, Sum, Max, Last).
  3. Hintergrund-Worker verarbeitet — Jede Minute ruft ein Worker neue Ereignisse seit dem letzten Checkpoint ab.
  4. Credits werden abgezogen — Die aggregierte Nutzung wird anhand des meter_units_per_credit-Verhältnisses in Credits umgerechnet und nach FIFO-Reihenfolge abgezogen (Zuteilungen mit dem frühesten Ablaufdatum werden zuerst verbraucht).
  5. Mehrverbrauch wird erfasst — Wenn das Guthaben null erreicht, wird die weitere Nutzung als Mehrverbrauch erfasst und gemäß dem konfigurierten Verhalten behandelt (beim Zurücksetzen erlassen, auf der nächsten Rechnung abgerechnet oder als Defizit vorgetragen). Dodo Payments blockiert die Nutzung nicht, wenn das Guthaben aufgebraucht ist. Um den Zugriff bei null zu stoppen, prüfen Sie das Guthaben in Ihrer Anwendung.
Der Credit-Abzug erfolgt asynchron (etwa alle 1 Minute). Zwischen der Erfassung eines Ereignisses und dem Abzug vom Guthaben kann eine kurze Verzögerung auftreten. Entwickeln Sie Ihre Anwendung so, dass sie diese Verzögerung berücksichtigt, und verlassen Sie sich bei der Zugriffskontrolle für einzelne Anfragen nicht auf Echtzeitprüfungen des Guthabens.

Mehrere Meter, ein Credit-Pool

Sie können mehrere Meter desselben Produkts mit demselben Credit Entitlement verknüpfen. Alle Meter ziehen vom selben gemeinsamen Guthaben ab. Beispiel: Eine AI-Plattform mit zwei Metern:
  • text.generation — 1 Credit pro 1.000 Token
  • 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.

Fehlerbehebung

  • Der Ereignisname muss exakt übereinstimmen (Groß-/Kleinschreibung wird berücksichtigt)
  • Prüfen Sie, dass die Meter-Filter keine Ereignisse ausschließen
  • Vergewissern Sie sich, dass die Kunden-IDs in Ihrem Konto vorhanden sind
  • Deaktivieren Sie die Filter vorübergehend zum Testen
  • Vergewissern Sie sich, dass die Over Property exakt mit dem Metadatenschlüssel übereinstimmt
  • Verwenden Sie Zahlen, keine Strings: tokens: 150 statt tokens: "150"
  • Fügen Sie die erforderlichen Eigenschaften in alle Ereignisse ein
  • Achten Sie auf die exakte Groß-/Kleinschreibung
  • Verwenden Sie die richtigen Operatoren für den Datentyp
  • Stellen Sie sicher, dass die Ereignisse die gefilterten Eigenschaften enthalten
  • Überprüfen Sie den Tab Events, um die tatsächlich empfangenen Ereignisse zu zählen
  • Prüfen Sie den Aggregationstyp (Count oder Sum)
  • Stellen Sie sicher, dass die Werte für Sum und Max numerisch sind

Nächste Schritte

Send Events

Beginne damit, Nutzungsevents aus deiner Anwendung an deine Meter zu senden.

View Blueprints

Nutze fertige Meter-Konfigurationen für gängige Anwendungsfälle.
Zuletzt geändert am 26. September 2026