Skip to main content
Låt ditt kodningsagent skriva integrationen genom att installera Dodo Agent Plugin. Det lägger till Dodo Payments-färdigheter och MCP-servrar i Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro och OpenCode.
Du ska bygga PixelGen AI, en exempelbaserad AI-bildgenereringstjänst som fakturerar kunder per bild med användningsbaserad fakturering. Du skapar mätaren för fakturering, produkten och exempelapplikationskoden som genererar bilder och rapporterar varje bild till Dodo Payments när det sker.
Den här handledningen innehåller exempelkod för en terminalapplikation. Du kan anpassa koden till ditt ramverk, till exempel React, Vue eller Angular, och till det sätt som din applikation samlar in användarinmatning på.
När du är klar har du en fungerande exempeltjänst som:
  • Genererar bilder med OpenAI:s gpt-image-2.5-flare-modell.
  • Spårar varje bildgenerering för fakturering.
  • Debiterar kunder för bilderna de genererar.
  • Hanterar två kvalitetsnivåer, medium och high.

Det här bygger vi

PixelGen AI fungerar så här:
  • Tjänst: AI-bildgenerering med OpenAI Image API
  • Prismodell: Betala per bild ($0.05 per bild)
  • Gratisnivå: 10 kostnadsfria bilder per kund och månad
  • Kvalitetsalternativ: Bilder av kvaliteten medium och high, till samma pris
Innan du börjar behöver du:
  • Ett Dodo Payments-konto.
  • Åtkomst till OpenAI API. OpenAI kan kräva API Organization Verification innan du använder GPT Image-modeller.
  • Node.js 22 eller senare samt kunskaper i TypeScript och Node.js.

Steg 1: Skapa din användningsmätare

Skapa en mätare i Dodo Payments-dashboarden som spårar varje bild som tjänsten genererar. Mätaren räknar de fakturerbara händelserna.
Formuläret Create Meter i Dodo Payments-dashboarden
Det här bygger du: En mätare med namnet “Image Generation Meter” som räknar varje bildgenerering.
1

Open the Meters Section

  1. Logga in på Dodo Payments-dashboarden.
  2. Gå till Products → Meters i sidofältet.
  3. Klicka på Create Meter.
Mätarformuläret öppnas.
2

Enter the Meter Details

Ange uppgifterna för PixelGen AI:Meter Name: Image Generation MeterBeskrivning: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generated
Händelsenamnet image.generated måste matcha händelsenamnet som applikationskoden skickar. Händelsenamn är skiftlägeskänsliga.
3

Configure How Images Are Counted

Ange aggregeringen, som styr hur mätaren kombinerar händelser:Aggregation Type: CountMeasurement Unit: images
Count fakturerar per genererad bild, inte efter storlek eller genereringstid. Varje lyckad bild är en fakturerbar enhet.
4

Add Quality Filtering

Händelsefiltrering i mätarformuläret med två kvalitetsvillkor sammanfogade med OR
Räkna bara riktiga bilder, inte testkörningar eller felaktiga händelser:
  1. Aktivera Enable Event Filtering.
  2. Ställ in matchningslogiken på OR, så att en händelse räknas när något villkor matchar.
  3. Lägg till det första villkoret:
    • Nyckel: quality
    • Operator: equals
    • Värde: medium
  4. Klicka på Add condition och lägg till det andra villkoret:
    • Nyckel: quality
    • Operator: equals
    • Värde: high
Med detta filter räknar mätaren endast händelser vars kvalitet är medium eller high och ignorerar testhändelser eller felaktigt formaterade händelser.
5

Create Your Meter

  1. Kontrollera att alla inställningar matchar värdena ovan. Du kan inte redigera en mätare efter att du har skapat den.
  2. Klicka på Create Meter.
Mätaren har skapats. “Image Generation Meter” är redo att räkna bildgenereringar. Därefter kopplar du den till en faktureringsprodukt.

Steg 2: Skapa din faktureringsprodukt

Skapa en produkt som definierar priset: $0.05 per bild, med 10 kostnadsfria bilder. Produkten kopplar mätaren till faktureringen.
Det här bygger du: En produkt som heter “PixelGen AI - Image Generation” och som debiterar $0.05 per bild efter de första 10 kostnadsfria bilderna varje månad.
1

Navigate to Products

  1. Klicka på Products i sidofältet i Dodo Payments-dashboarden.
  2. Klicka på Add Product.
  3. Välj Usage Based Billing under Pricing Type.
Med den här pristypen fakturerar Dodo Payments utifrån mätarens användning i stället för ett fast prenumerationspris.
2

Enter Product Details

Ange dessa värden:Product Name: PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: Ladda upp en tydlig och relevant bild.
Namnet och beskrivningen visas på kundernas fakturor.
3

Connect Your Meter

Prissättning för Usage Based Billing i produktformuläret med avsnittet Associated Meters
Kontrollera att produktens pristyp är Usage Based Billing.Ange Price till 0, så att kunderna bara betalar för användning utan någon grundavgift.Koppla sedan mätaren som du skapade:
  1. Bläddra till avsnittet Associated Meters.
  2. Klicka på Add meters.
  3. Välj “Image Generation Meter” i listrutan.
  4. Bekräfta att mätaren visas i produktkonfigurationen.
Mätaren är kopplad till produkten.
4

Set Your Pricing

Definiera priset per bild och den kostnadsfria nivån:
Mätarprissättning med fält för pris per enhet och kostnadsfri gräns
Price per unit: 0.05, vilket är $0.05 per bild.Free Threshold: 10. Varje kund får 10 kostnadsfria bilder per månad.
Så fungerar faktureringen: En kund som genererar 25 bilder under en månad betalar för 15 bilder (25 − 10 kostnadsfria). 15 × $0.05 = $0.75.
5

Save Your Product

  1. Granska inställningarna:
    • Namn: PixelGen AI - Image Generation
    • Mätare: Image Generation Meter
    • Pris: $0.05 per bild
    • Gratisnivå: 10 bilder
  2. Klicka på Save Changes.
Produkten har skapats. Faktureringen är konfigurerad och kunderna debiteras för bilderna de genererar.

Steg 3: Gör ett testköp

Köp produkten en gång i testläge. Köpet skapar kunden som appen skickar användningshändelser för.
1

Get Your Payment Link

  1. Gå till Products i Dodo Payments-dashboarden.
  2. Leta reda på produkten “PixelGen AI - Image Generation”.
  3. Klicka på Share bredvid produkten.
  4. Kopiera betalningslänken.
Betalningslänken ser ut så här: https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1.
2

Complete a Test Purchase

  1. Öppna betalningslänken på en ny webbläsarflik.
  2. Ange testbetalningsuppgifter och slutför köpet.
När betalningen har genomförts skapar köpet en kund. Applikationskoden använder kundens ID.
3

Find Your Customer ID

  1. Gå tillbaka till Dodo Payments-dashboarden.
  2. Gå till Sales → Customers i sidofältet.
  3. Leta reda på kunden du skapade med testets e-postadress.
  4. Kopiera kundens ID. Det ser ut så här: cus_abc123def456.
Spara detta kund-ID. Exempelapplikationen anger det i koden, så att varje händelse registreras för denna kund.

Steg 4: Bygg exempelapplikationen

När faktureringen är konfigurerad och en testkund har skapats bygger du exempelapplikationen PixelGen AI. Den genererar en bild och rapporterar den till Dodo Payments för fakturering.
Exemplet anropar OpenAI:s gpt-image-2.5-flare-modell via Image API. Image API returnerar base64-kodad bilddata, så exemplet sparar varje bild som en PNG-fil. Dodo Payments-delen (mätaren, produkten och användningshändelsen image.generated) beror inte på modellen.
1

Set Up Your Project

Skapa en katalog och initiera projektet:
2

Install Dependencies

Installera paketen:
3

Create the Main Application

Skapa en fil med namnet index.ts och klistra in applikationskoden nedan.
Den fullständiga PixelGen AI-applikationen med fakturering, samt motsvarande .env och package.json:

Steg 5: Testa exempelapplikationen

Testa PixelGen AI från början till slut och se användningen nå Dodo Payments.
Det här testar du: Du genererar några bilder, bekräftar att händelserna når Dodo Payments och kontrollerar faktureringsberäkningen.
1

Set Up Your Environment

  1. Skapa en fil med namnet .env i katalogen pixelgen-ai.
  2. Lägg till dina API-nycklar:
  1. Installera beroendena och kör appen:
Använd riktiga API-nycklar och ersätt det hårdkodade kund-ID:t i index.ts med kund-ID:t från steg 3.
2

Generate Your First Test Image

När appen startar skriver den ut:
Ange denna prompt: “En söt robot som målar ett landskap”Utdata ser ut så här. Felsökningsraderna för begäran som sendUsageEvent skriver ut har utelämnats:
Om utdatan innehåller “Usage event sent successfully” fungerar faktureringsintegrationen.
3

Generate a Few More Images

Generera ytterligare två eller tre bilder för att testa flera händelser. Kör npm start en gång per bild med dessa promptar:
  1. “En solnedgång över berg med lila moln”
  2. “En steampunk-kaffemaskin i ett viktorianskt kök”
  3. “En vänlig drake som läser en bok på ett bibliotek”
Kontrollera meddelandet “Usage event sent successfully” varje gång.
4

Check Your Dodo Payments Dashboard

Bekräfta att Dodo Payments tar emot händelserna:
  1. Öppna Dodo Payments-dashboarden.
  2. Gå till Products → Meters och öppna Image Generation Meter.
  3. Välj fliken Events.
  4. Leta efter dina bildgenereringshändelser i listan.
Det här ska du leta efter:
  • Händelsenamn: image.generated
  • Kund-ID: ditt testkund-ID
Listan innehåller en händelse för varje bild du genererade.
5

Verify Billing Calculations

Kontrollera användningsantalet:
Fliken Customers i mätaren som visar förbrukade enheter per kund
  1. Välj fliken Customers i mätaren.
  2. Leta reda på din testkund.
  3. Kontrollera kolumnen Consumed Units.
6

Test the Billing Threshold

Överskrid den kostnadsfria nivån för att se fakturering:
  1. Generera 8 bilder till, totalt 12.
  2. Öppna mätarens flik Customers igen.
  3. Kontrollera värdena:
    • Consumed Units: 12
    • Chargeable Units: 2 (12 − 10 kostnadsfria)
    • Total Price: $0.10
Användningsbaserad fakturering fungerar. Kunderna debiteras för bilderna de genererar.

Felsökning

Vanliga problem och deras lösningar:
Möjliga orsaker:
  • Händelsenamnet matchar inte mätarkonfigurationen exakt
  • Kund-ID:t finns inte i ditt konto
  • API-nyckeln är ogiltig eller har upphört att gälla
  • Problem med nätverksanslutningen
Lösningar:
  1. Kontrollera att händelsenamnet matchar mätaren exakt. Det är skiftlägeskänsligt.
  2. Kontrollera att kund-ID:t finns i Dodo Payments.
  3. Testa API-nyckeln med ett enkelt API-anrop.
  4. Kontrollera nätverksanslutningen och brandväggsinställningarna.

Grattis! Du har byggt PixelGen AI

Du har byggt en exempelbaserad AI-bildgenerator med användningsbaserad fakturering:

Usage Meter

En “Image Generation Meter” som räknar varje bildgenereringshändelse.

Billing Product

Prissättning på $0.05 per bild, med 10 kostnadsfria bilder per månad.

AI Application

En TypeScript-app som genererar bilder med OpenAI image API.

Automated Billing

Händelsespårning som rapporterar varje bild när den genereras, så att kunderna faktureras för användningen.
Senast ändrad 26 september 2026