Skip to main content
Damit dein Coding-Agent die Integration schreibt, installiere das Dodo Agent Plugin. Es fügt Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro und OpenCode die Dodo Payments-Skills und MCP-Server hinzu.
Du erstellst PixelGen AI, einen Beispielservice zur KI-Bildgenerierung, der Kunden pro Bild über eine nutzungsbasierte Abrechnung abrechnet. Du erstellst den Billing-Meter, das Produkt und den Beispielanwendungscode, der Bilder generiert und jedes Bild direkt an Dodo Payments meldet.
Dieses Tutorial enthält Beispielcode für eine Terminalanwendung. Du kannst den Code an dein Framework, etwa React, Vue oder Angular, sowie an die Art anpassen, wie deine Anwendung Benutzereingaben erfasst.
Wenn du fertig bist, hast du einen funktionierenden Beispieldienst, der:
  • Bilder mit dem gpt-image-2.5-flare-Modell von OpenAI generiert.
  • Jede Bildgenerierung für die Abrechnung erfasst.
  • Kunden die von ihnen generierten Bilder in Rechnung stellt.
  • Zwei Qualitätsstufen verarbeitet: medium und high.

Was wir erstellen

PixelGen AI funktioniert folgendermaßen:
  • Dienst: KI-Bildgenerierung mit der OpenAI Image API
  • Preismodell: Bezahlung pro Bild ($0.05 pro Bild)
  • Kostenlose Stufe: 10 kostenlose Bilder pro Kunde und Monat
  • Qualitätsoptionen: Bilder der Qualitätsstufen medium und high zum gleichen Preis
Bevor du beginnst, benötigst du:
  • Ein Dodo Payments-Konto.
  • Zugriff auf die OpenAI API. OpenAI verlangt möglicherweise eine API Organization Verification, bevor du GPT Image-Modelle verwenden kannst.
  • Node.js 22 oder höher sowie praktische Kenntnisse in TypeScript und Node.js.

Schritt 1: Erstelle deinen Usage-Meter

Erstelle im Dodo Payments-Dashboard einen Meter, der jedes vom Service generierte Bild erfasst. Der Meter zählt die abrechenbaren Ereignisse.
Formular zum Erstellen eines Meters im Dodo Payments-Dashboard
Was du erstellst: Einen Meter namens “Image Generation Meter”, der jede Bildgenerierung zählt.
1

Open the Meters Section

  1. Melde dich im Dodo Payments-Dashboard an.
  2. Gehe in der Seitenleiste zu Products → Meters.
  3. Klicke auf Create Meter.
Das Meter-Formular wird geöffnet.
2

Enter the Meter Details

Gib die Details für PixelGen AI ein:Meter Name: Image Generation MeterBeschreibung: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generated
Der Event Name image.generated muss mit dem Event Name übereinstimmen, den der Anwendungscode sendet. Bei Event Names wird zwischen Groß- und Kleinschreibung unterschieden.
3

Configure How Images Are Counted

Lege die Aggregation fest, die bestimmt, wie der Meter Ereignisse kombiniert:Aggregation Type: CountMeasurement Unit: images
Count rechnet pro generiertem Bild ab, nicht nach Größe oder Generierungsdauer. Jedes erfolgreich generierte Bild ist eine abrechenbare Einheit.
4

Add Quality Filtering

Ereignisfilterung im Meter-Formular mit zwei durch OR verbundenen Qualitätsbedingungen
Zähle nur echte Bilder, keine Testläufe oder fehlerhaften Ereignisse:
  1. Aktiviere Enable Event Filtering.
  2. Setze die Abgleichlogik auf OR, damit ein Ereignis gezählt wird, sobald eine beliebige Bedingung erfüllt ist.
  3. Füge die erste Bedingung hinzu:
    • Schlüssel: quality
    • Operator: equals
    • Wert: medium
  4. Klicke auf Add condition und füge die zweite Bedingung hinzu:
    • Schlüssel: quality
    • Operator: equals
    • Wert: high
Mit diesem Filter zählt der Meter nur Ereignisse, deren Qualität medium oder high entspricht, und ignoriert Test- oder fehlerhafte Ereignisse.
5

Create Your Meter

  1. Überprüfe, dass jede Einstellung mit den oben genannten Werten übereinstimmt. Nach dem Erstellen kannst du einen Meter nicht mehr bearbeiten.
  2. Klicke auf Create Meter.
Meter erstellt. Der “Image Generation Meter” ist bereit, Bildgenerierungen zu zählen. Als Nächstes verknüpfst du ihn mit einem Billing-Produkt.

Schritt 2: Erstelle dein Billing-Produkt

Erstelle ein Produkt, das die Preisgestaltung definiert: $0.05 pro Bild bei 10 kostenlosen Bildern. Das Produkt verknüpft den Meter mit der Abrechnung.
Was du erstellst: Ein Produkt namens “PixelGen AI - Image Generation”, das nach den ersten 10 kostenlosen Bildern pro Monat $0.05 pro Bild berechnet.
1

Navigate to Products

  1. Klicke im Dodo Payments-Dashboard in der Seitenleiste auf Products.
  2. Klicke auf Add Product.
  3. Wähle unter Pricing Type die Option Usage Based Billing aus.
Bei diesem Preistyp rechnet Dodo Payments anhand der Meter-Nutzung statt anhand eines festen Abonnementpreises ab.
2

Enter Product Details

Gib diese Werte ein:Product Name: PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: Lade ein klares, passendes Bild hoch.
Name und Beschreibung erscheinen auf den Kundenrechnungen.
3

Connect Your Meter

Usage Based Billing als Preistyp im Produktformular mit dem Abschnitt Associated Meters
Überprüfe, dass der Preistyp des Produkts Usage Based Billing ist.Setze den Price auf 0, damit Kunden nur für die Nutzung und keine Grundgebühr bezahlen.Verknüpfe anschließend den erstellten Meter:
  1. Scrolle zum Abschnitt Associated Meters.
  2. Klicke auf Add meters.
  3. Wähle im Dropdown “Image Generation Meter” aus.
  4. Bestätige, dass der Meter in der Produktkonfiguration angezeigt wird.
Der Meter ist mit dem Produkt verknüpft.
4

Set Your Pricing

Lege den Preis pro Bild und die kostenlose Stufe fest:
Meter-Preisgestaltung mit Feldern für Preis pro Einheit und kostenlose Schwelle
Price per unit: 0.05, also $0.05 pro Bild.Free Threshold: 10. Jeder Kunde erhält 10 kostenlose Bilder pro Monat.
So funktioniert die Abrechnung: Ein Kunde, der in einem Monat 25 Bilder generiert, bezahlt 15 Bilder (25 − 10 kostenlose). 15 × $0.05 = $0.75.
5

Save Your Product

  1. Überprüfe die Einstellungen:
    • Name: PixelGen AI - Image Generation
    • Meter: Image Generation Meter
    • Price: $0.05 pro Bild
    • Kostenlose Stufe: 10 Bilder
  2. Klicke auf Save Changes.
Produkt erstellt. Die Abrechnung ist konfiguriert, und Kunden werden für die von ihnen generierten Bilder belastet.

Schritt 3: Tätige einen Testkauf

Kaufe das Produkt einmal im Testmodus. Durch den Kauf wird der Kunde erstellt, für den die Anwendung Nutzungsereignisse sendet.
1

Get Your Payment Link

  1. Gehe im Dodo Payments-Dashboard zu Products.
  2. Suche das Produkt “PixelGen AI - Image Generation”.
  3. Klicke neben dem Produkt auf Share.
  4. Kopiere den Zahlungslink.
Der Zahlungslink sieht wie https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1 aus.
2

Complete a Test Purchase

  1. Öffne den Zahlungslink in einem neuen Browser-Tab.
  2. Gib Test-Zahlungsdaten ein und schließe den Kauf ab.
Nach erfolgreicher Zahlung wird durch den Kauf ein Kunde erstellt. Der Anwendungscode verwendet die ID dieses Kunden.
3

Find Your Customer ID

  1. Gehe zurück zum Dodo Payments-Dashboard.
  2. Gehe in der Seitenleiste zu Sales → Customers.
  3. Suche den erstellten Kunden anhand seiner Test-E-Mail-Adresse.
  4. Kopiere die Kunden-ID. Sie sieht wie cus_abc123def456 aus.
Speichere diese Kunden-ID. Die Beispielanwendung setzt sie im Code, damit jedes Ereignis für diesen Kunden erfasst wird.

Schritt 4: Erstelle die Beispielanwendung

Nachdem die Abrechnung eingerichtet und ein Testkunde erstellt wurde, erstellst du die Beispielanwendung PixelGen AI. Sie generiert ein Bild und meldet es zur Abrechnung an Dodo Payments.
Das Beispiel ruft das gpt-image-2.5-flare-Modell von OpenAI über die Image API auf. Die Image API gibt base64-kodierte Bilddaten zurück, daher speichert das Beispiel jedes Bild als PNG-Datei. Der Dodo Payments-Teil (der Meter, das Produkt und das image.generated-Nutzungsereignis) ist nicht vom Modell abhängig.
1

Set Up Your Project

Erstelle ein Verzeichnis und initialisiere das Projekt:
2

Install Dependencies

Installiere die Pakete:
3

Create the Main Application

Erstelle eine Datei namens index.ts und füge den Anwendungscode unten ein.
Die vollständige PixelGen AI-Anwendung mit Abrechnung sowie dem passenden .env und package.json:

Schritt 5: Teste deine Beispielanwendung

Teste PixelGen AI durchgängig und beobachte, wie die Nutzung Dodo Payments erreicht.
Was du testest: Du generierst einige Bilder, bestätigst, dass die Ereignisse Dodo Payments erreichen, und überprüfst die Abrechnungsberechnung.
1

Set Up Your Environment

  1. Erstelle im Verzeichnis pixelgen-ai eine Datei .env.
  2. Füge deine API-Schlüssel hinzu:
  1. Installiere die Abhängigkeiten und starte die Anwendung:
Verwende echte API-Schlüssel und ersetze die fest codierte Kunden-ID in index.ts durch die Kunden-ID aus Schritt 3.
2

Generate Your First Test Image

Beim Start der Anwendung wird Folgendes ausgegeben:
Gib diesen Prompt ein: “A cute robot painting a landscape”Die Ausgabe sieht folgendermaßen aus. Die von sendUsageEvent ausgegebenen Debug-Zeilen der Anfrage wurden weggelassen:
Wenn die Ausgabe “Usage event sent successfully” enthält, funktioniert die Billing-Integration.
3

Generate a Few More Images

Generiere zwei oder drei weitere Bilder, um mehrere Ereignisse zu testen. Führe npm start einmal pro Bild mit den folgenden Prompts aus:
  1. “A sunset over mountains with purple clouds”
  2. “A steampunk coffee machine in a Victorian kitchen”
  3. “A friendly dragon reading a book in a library”
Überprüfe jedes Mal, ob die Meldung “Usage event sent successfully” angezeigt wird.
4

Check Your Dodo Payments Dashboard

Bestätige, dass Dodo Payments die Ereignisse empfängt:
  1. Öffne das Dodo Payments-Dashboard.
  2. Gehe zu Products → Meters und öffne Image Generation Meter.
  3. Wähle den Tab Events aus.
  4. Suche deine Bildgenerierungsereignisse in der Liste.
Das solltest du überprüfen:
  • Event Name: image.generated
  • Customer ID: deine Testkunden-ID
Die Liste enthält ein Ereignis für jedes von dir generierte Bild.
5

Verify Billing Calculations

Überprüfe den Nutzungszähler:
Customers-Tab des Meters mit den verbrauchten Einheiten pro Kunde
  1. Wähle im Meter den Tab Customers aus.
  2. Suche deinen Testkunden.
  3. Überprüfe die Spalte Consumed Units.
6

Test the Billing Threshold

Überschreite die kostenlose Stufe, um die Abrechnung zu sehen:
  1. Generiere 8 weitere Bilder, also insgesamt 12.
  2. Öffne erneut den Tab Customers des Meters.
  3. Überprüfe die Werte:
    • Consumed Units: 12
    • Chargeable Units: 2 (12 − 10 kostenlos)
    • Total Price: $0.10
Die nutzungsbasierte Abrechnung funktioniert. Kunden werden für die von ihnen generierten Bilder belastet.

Fehlerbehebung

Häufige Probleme und ihre Lösungen:
Mögliche Ursachen:
  • Der Event Name stimmt nicht exakt mit der Meter-Konfiguration überein
  • Die Customer ID existiert nicht in deinem Konto
  • Der API-Schlüssel ist ungültig oder abgelaufen
  • Probleme mit der Netzwerkverbindung
Lösungen:
  1. Überprüfe, dass der Event Name exakt mit dem Meter übereinstimmt. Bei ihm wird zwischen Groß- und Kleinschreibung unterschieden.
  2. Überprüfe, dass die Customer ID in Dodo Payments existiert.
  3. Teste den API-Schlüssel mit einem einfachen API-Aufruf.
  4. Überprüfe die Netzwerkverbindung und die Firewall-Einstellungen.

Glückwunsch! Du hast PixelGen AI erstellt

Du hast einen Beispiel-KI-Bildgenerator mit nutzungsbasierter Abrechnung erstellt:

Usage Meter

Einen “Image Generation Meter”, der jedes Bildgenerierungsereignis zählt.

Billing Product

Eine Preisgestaltung von $0.05 pro Bild bei 10 kostenlosen Bildern pro Monat.

AI Application

Eine TypeScript-Anwendung, die Bilder mit der OpenAI image API generiert.

Automated Billing

Event-Tracking, das jedes Bild bei seiner Generierung meldet, sodass Kunden für ihre Nutzung abgerechnet werden.
Zuletzt geändert am 26. September 2026