> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nutzungsbasierte Abrechnung

> Berechnen Sie Kunden basierend auf dem, was sie tatsächlich nutzen, mit flexibler Messung und automatisierter Abrechnung.

Die nutzungsbasierte Abrechnung ermöglicht es Ihnen, Kunden für das zu berechnen, was sie tatsächlich nutzen – API-Aufrufe, Speicher, KI-Token oder jede Metrik, die Sie definieren. Kunden zahlen für den Verbrauch, nicht für feste Gebühren.

<Info>
  **Perfekt für**: APIs, KI-Services, Infrastrukturplattformen und jedes Produkt, dessen Wert mit der Nutzung skaliert.
</Info>

## So funktioniert es

<Steps>
  <Step title="Send Usage Events">
    Ihre Anwendung sendet Ereignisse, wenn abrechenbare Aktionen stattfinden.

    ```javascript theme={null}
    {
      "event_id": "evt_123",
      "customer_id": "cus_abc",
      "event_name": "api.call",
      "metadata": { "endpoint": "/v1/users" }
    }
    ```
  </Step>

  <Step title="Meters Aggregate Usage">
    Meter aggregieren Ereignisse zu abrechenbaren Mengen mithilfe von Count, Sum, Max oder Last.
  </Step>

  <Step title="Automatic Billing">
    Legen Sie den Preis pro Einheit und kostenlose Schwellenwerte fest. Kunden werden automatisch in jedem Abrechnungszyklus belastet.
  </Step>
</Steps>

## Kernkonzepte

### Ereignisse

Ereignisse stellen Nutzungsaktionen in Ihrer Anwendung dar. Jedes Ereignis enthält:

* **Ereignisname**: Art der Nutzung (z. B. `api.call`)
* **Kunden-ID**: Wer es genutzt hat
* **Metadaten**: Zusätzliche Eigenschaften für die Aggregation

### Zähler

Zähler aggregieren Ereignisse in abrechnungsfähige Mengen:

* **Count**: Gesamte Ereignisse (API-Aufrufe)
* **Sum**: Werte addieren (insgesamt Bytes)
* **Max**: Höchster Wert (Spitzenbenutzer)
* **Last**: Jüngster Wert

<Frame>
  <img src="https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?fit=max&auto=format&n=w9oVTi6CzZMAOQA3&q=85&s=f9d85a463fba231437151db3d4a2052a" alt="Zähleroberfläche erstellen" style={{ maxHeight: '500px', width: 'auto' }} width="2324" height="1600" data-path="images/usage-based/UBB-2.png" />
</Frame>

### Produkte mit nutzungsbasierter Preisgestaltung

Legen Sie Preise pro Einheit und optionale kostenlose Schwellenwerte fest:

<Frame>
  <img src="https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-4.png?fit=max&auto=format&n=w9oVTi6CzZMAOQA3&q=85&s=b2d07bb408fd79e1b788c1b7092b8bca" alt="Preisgestaltungskonfiguration" style={{ maxHeight: '500px', width: 'auto' }} width="732" height="712" data-path="images/usage-based/UBB-4.png" />
</Frame>

**Beispiel**: 2.500 Aufrufe - 1.000 kostenlos = 1.500 × $0.02 = $30.00

### Guthabenbasierter Abzug

Anstatt pro Einheit in US-Dollar zu berechnen, können Sie Zähler so konfigurieren, dass sie vom [Guthaben](/features/credit-based-billing) eines Kunden abziehen. Guthaben werden mit jedem Abrechnungszyklus erneuert und vor etwaigen Überziehungsgebühren angewendet.

## Schnellstart

<Steps>
  <Step title="Create a Meter">
    In Ihrem Dashboard: **Meter** → **Create Meter**

    1. Legen Sie den Ereignisnamen fest (z. B. `api.call`)
    2. Wählen Sie eine Aggregation (Count, Sum, Max, Last)
    3. Fügen Sie optional Filter hinzu
  </Step>

  <Step title="Add to Product">
    Verknüpfen Sie das Meter mit einem Produkt samt Preisgestaltung:

    <Frame>
      <img src="https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-5.png?fit=max&auto=format&n=w9oVTi6CzZMAOQA3&q=85&s=fd3851a1a070714baf0aec01cff717b8" alt="Zähler zu Produkt hinzufügen" style={{ maxHeight: '500px', width: 'auto' }} width="2272" height="1422" data-path="images/usage-based/UBB-5.png" />
    </Frame>

    1. Wählen Sie **Usage-Based Billing**
    2. Wählen Sie Ihr Meter
    3. Legen Sie den Preis pro Einheit und den kostenlosen Schwellenwert fest
  </Step>

  <Step title="Send Events">
    ```javascript theme={null}
    await fetch('https://test.dodopayments.com/events/ingest', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        events: [{
          event_id: "unique_event_id",
          customer_id: "cus_abc123",
          event_name: "api.call",
          metadata: { endpoint: "/v1/users" }
        }]
      })
    });
    ```
  </Step>

  <Step title="Monitor Usage">
    <Frame>
      <img src="https://mintcdn.com/dodopayments/16r81mgDWvSgYER7/images/guides/usage-based-billing/meter-quantities-chart.png?fit=max&auto=format&n=16r81mgDWvSgYER7&q=85&s=1a8a39547bd0259a53d4591d7928c8ea" alt="Zähler-Dashboard" style={{ maxHeight: '500px', width: 'auto' }} width="1602" height="888" data-path="images/guides/usage-based-billing/meter-quantities-chart.png" />
    </Frame>

    Überprüfen Sie das Dashboard Ihres Meters, um Ereignisse und Nutzungsaggregationen zu sehen. Kunden werden automatisch in jedem Zyklus abgerechnet.
  </Step>
</Steps>

## Anwendungsfälle

<CardGroup cols={2}>
  <Card title="APIs & Infrastructure" icon="cloud">
    Verfolgen Sie API-Aufrufe, Compute-Stunden, Bandbreite, Speicher. Beispiel: 0,001 \$ pro Aufruf nach 10.000 Gratisaufrufen.
  </Card>

  <Card title="AI Usage Tracking" icon="brain">
    Verfolgen Sie Tokens, Generierungen, Verarbeitungszeit. Beispiel: 0,04 $ pro Standardbild, 0,08 $ pro HD.
  </Card>

  <Card title="Data & Analytics" icon="chart-line">
    Rechnen Sie nach verarbeiteten Daten, ausgeführten Abfragen, analysierten Datensätzen ab. Beispiel: 5 \$ pro GB nach 10 GB frei.
  </Card>

  <Card title="Communication" icon="message">
    Zählen Sie Nachrichten, Minuten, übertragene Daten. Beispiel: 0,01 \$ pro gesendeter SMS.
  </Card>
</CardGroup>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Event Ingestion" icon="bolt" href="/features/usage-based-billing/event-ingestion">
    Erfahren Sie, wie Sie Nutzungsereignisse aus Ihrer Anwendung strukturieren und senden.
  </Card>

  <Card title="Meters Guide" icon="sliders" href="/features/usage-based-billing/meters">
    Meistern Sie Meter-Konfiguration, Aggregationstypen und Ereignisfilter.
  </Card>

  <Card title="Complete Tutorial" icon="code" href="/developer-resources/usage-based-billing-build-ai-image-generator">
    Erstellen Sie einen vollständigen KI-Bildgenerator mit nutzungsbasierter Abrechnung von Grund auf.
  </Card>

  <Card title="Integration Guide" icon="book" href="/developer-resources/usage-based-billing-guide">
    Umfassender Leitfaden zur Implementierung nutzungsbasierter Abrechnung in Ihrer Anwendung.
  </Card>
</CardGroup>
