Skip to main content
Låt din kodagent skriva integrationen genom att installera Dodo Agent Plugin. Det lägger till Dodo Payments-färdigheterna och MCP-servrarna i Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro och OpenCode.
Du ska bygga en AI-chattapplikation som debiterar kunderna för de tokens de använder. Du skapar mätaren, produkten och applikationskoden som kör konversationer och rapporterar tokenanvändningen medan den sker.
Den här handledningen bygger en komplett applikation med en backend och en frontend. Chattappen använder Google Gemini, och LLM Blueprint rapporterar tokenanvändningen för varje svar, så du behöver inte räkna tokens själv.
När du är klar har du en chattapplikation som:
  • Kör AI-konversationer med Google Gemini genom AI SDK.
  • Spårar tokenanvändningen automatiskt, utan kod för tokenräkning.
  • Debiterar kunderna för de tokens de faktiskt använder.
  • Innehåller ett chattgränssnitt som bevarar konversationshistoriken.
Chattgränssnitt för den färdiga AI-chatten, som visar en konversation med tokenantal under varje svar

Det här bygger vi

Chattjänsten fungerar så här:
  • Tjänst: AI-chatt med Google Gemini genom AI SDK
  • Prismodell: Betala per token ($0.01 per 1 000 tokens)
  • Gratisnivå: 10 000 kostnadsfria tokens per kund och månad
  • Funktioner: Konversationshistorik och automatisk tokenspårning
Innan du börjar behöver du:

Steg 1: Skapa din användningsmätare

Skapa en mätare i Dodo Payments-dashboarden för att spåra AI-tokenanvändning.
Det här bygger du: En mätare med namnet “AI Token Usage Meter” som summerar tokens som används i chattkonversationer.
1

Open the Meters Section

  1. Logga in på Dodo Payments-dashboarden.
  2. Klicka på Products i sidofältet.
  3. Klicka på Meters.
  4. Klicka på Create Meter.
Meters-sidan i Dodo Payments-dashboarden med knappen Create Meter
Mätarformuläret öppnas.
2

Enter the Meter Details

Ange uppgifterna för chattjänsten:Meter Name → AI Token Usage MeterDescription → Tracks token consumption from AI chat conversations using AI SDKEvent Name → ai_chat_usage
Händelsenamnet ai_chat_usage måste överensstämma med händelsenamnet som applikationskoden skickar. Händelsenamn är skiftlägeskänsliga.
3

Configure How Tokens Are Counted

Ange aggregeringen, som styr hur mätaren kombinerar händelser:Aggregation Type: SumOver Property: totalTokensMeasurement Unit: tokens
Sum summerar tokens från varje chattmeddelande. LLM Blueprint skickar inputTokens, outputTokens och totalTokens i varje händelses metadata, och den här mätaren summerar totalTokens.
4

Create the Meter

  1. Kontrollera att alla inställningar överensstämmer med värdena ovan. Du kan inte redigera en mätare efter att du har skapat den.
  2. Klicka på Create Meter.
Mätarformulär ifyllt med namnet AI Token Usage Meter, händelsen ai_chat_usage och aggregeringen Sum
Mätaren är skapad. “AI Token Usage Meter” är redo att räkna tokens. Nästa steg är att koppla den till en billingprodukt.

Steg 2: Hämta dina API-nycklar

Samla in de två API-nycklar som appen behöver.
1

Get a Dodo Payments API Key

  1. Gå till Developer → API Keys i Dodo Payments-dashboarden.
  2. Klicka på Add API Key.
  3. Kopiera API-nyckeln.
Skapa nyckeln i testläge: en nyckel i testläge fungerar endast med testläge. Du lägger till nyckeln i filen .env i steg 5.
2

Get a Google AI API Key

  1. Gå till aistudio.google.com.
  2. Klicka på Get API Key.
  3. Skapa en API-nyckel eller använd en befintlig.
  4. Kopiera nyckeln.
Håll den här nyckeln privat. Du lägger till den i filen .env i steg 5.

Steg 3: Skapa din faktureringsprodukt

Skapa en produkt som definierar prissättningen: $0.01 per 1 000 tokens, med 10 000 kostnadsfria tokens. Produkten kopplar mätaren till billing.
Det här bygger du: En produkt med namnet “AI Chat Service” som debiterar för tokenanvändning över en gratisnivå.
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 debiterar Dodo Payments utifrån mätaranvändning i stället för ett fast prenumerationspris.
2

Enter Product Details

Fyll i de obligatoriska uppgifterna:Product Name: → AI Chat ServiceDescription: → AI-powered chat service with automatic token-based billingProduct Image: Ladda upp en relevant bild.
Namnet och beskrivningen visas på kundfakturor.
3

Connect Your Meter

Kontrollera att produktens pristyp är Usage Based Billing.Ange Price till 0, så att kunderna endast betalar för användningen, utan grundavgift.Koppla sedan mätaren du skapade:
  1. Bläddra till avsnittet Associated Meters.
  2. Klicka på Add meters.
  3. Välj “AI Token Usage Meter” i rullgardinsmenyn.
  4. Bekräfta att mätaren visas i produktkonfigurationen.
Mätaren är kopplad till produkten.
4

Set Your Pricing

Definiera priset per token och gratisnivån:Price per unit: → 0.00001. Det motsvarar $0.00001 per token eller $0.01 per 1 000 tokens.Free Threshold: → 10000. Varje kund får 10 000 kostnadsfria tokens per månad.
Mätarprissättning för produkten AI Chat Service, med pris per enhet och gratisgräns ifyllda
Så fungerar billing: En kund som använder 25 000 tokens under en månad betalar för 15 000 tokens (25 000 − 10 000 kostnadsfria). 15 000 × $0.00001 = $0.15.
5

Save Your Product

  1. Granska inställningarna:
    • Namn: AI Chat Service
    • Mätare: AI Token Usage Meter
    • Pris: $0.01 per 1 000 tokens
    • Gratisnivå: 10 000 tokens
  2. Klicka på Save Changes.
Produkten är skapad. Billing är konfigurerad och kunderna debiteras för de tokens de använder.

Steg 4: Gör ett testköp

Skapa en testkund genom att köpa produkten. Appen skickar användningshändelser för den här kunden.
1

Get Your Payment Link

  1. Gå till Products i Dodo Payments-dashboarden.
  2. Leta reda på produkten “AI Chat Service”.
  3. Klicka på Share bredvid produkten.
  4. Kopiera betalningslänken.
2

Complete a Test Purchase

  1. Öppna betalningslänken i 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 hjälp av testens e-postadress.
  4. Kopiera kund-ID:t. Det börjar med cus_.
Spara kund-ID:t. Du använder det när du testar chattapplikationen.

Steg 5: Bygg chattapplikationen

När billing är konfigurerad och en testkund har skapats bygger du chattapplikationen.
1

Set Up Your Project

Skapa en katalog och initiera projektet:
2

Install Dependencies

Installera paketen:
3

Configure TypeScript

Skapa tsconfig.json:
tsconfig.json
Uppdatera package.json för att lägga till modultypen och skripten:
package.json
4

Create the Project Structure

Skapa mapparna för källkod och statiska filer:
5

Set Up Environment Variables

Skapa en .env-fil i projektroten:
.env
Ersätt platshållarvärdena med API-nycklarna från steg 2. Google-providern för AI SDK läser GOOGLE_GENERATIVE_AI_API_KEY som standard.
6

Create the Backend Server

Skapa src/server.ts och klistra in serverkoden nedan.
Den kompletta chattservern med billing, tillsammans med den matchande .env och package.json:

Steg 6: Lägg till chattgränssnittet

Lägg till ett chattgränssnitt som bevarar hela konversationshistoriken. Skapa public/index.html:
public/index.html

Steg 7: Testa chattapplikationen

Testa chattappen från början till slut och se hur användningen når Dodo Payments.
Det här testar du: Du chattar med AI:n, bekräftar att tokenhändelserna når Dodo Payments och kontrollerar billingberäkningen.
1

Start the Server

  1. Kontrollera att filen .env innehåller båda API-nycklarna från steg 2.
  2. Starta utvecklingsservern:
Serverloggarna:
Servern körs.
2

Open the Chat Interface

  1. Öppna webbläsaren.
  2. Gå till http://localhost:3000. Chattgränssnittet läses in.
Innan du chattar anger du CUSTOMER_ID i server.ts till testkundens ID från steg 4 och startar sedan om servern.
3

Have Your First Conversation

Skicka följande meddelanden:
  1. “Vad är artificiell intelligens?”
  2. “Hur fungerar maskininlärning?”
  3. “Kan du förklara neurala nätverk?”
Varje svar visar hur många tokens det använde.
Om AI:n svarar och tokenantal visas fungerar appen.
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 AI Token Usage Meter.
  3. Välj fliken Events.
  4. Leta reda på dina chatthändelser i listan.
Det här ska du leta efter:
  • Händelsenamn: ai_chat_usage
  • Kund-ID: ditt testkund-ID
Fliken Events för AI Token Usage Meter med ai_chat_usage-händelser
Listan innehåller en händelse för varje meddelande du skickade.
5

Verify Token Counting

Skicka några fler meddelanden och kontrollera sedan aggregeringen:
  1. Välj fliken Customers i mätaren.
  2. Leta reda på din testkund.
  3. Kontrollera kolumnen Consumed Units. Den visar det totala antalet använda tokens.
Fliken Customers för mätaren som visar förbrukade enheter för testkunden
Mätaren summerar värdet totalTokens från varje händelse.
6

Test the Free Tier

Använd tillräckligt många tokens för att överskrida gratisnivån:
  1. Ha flera fler konversationer tills totalen överstiger ungefär 15 000 tokens.
  2. Öppna mätarens flik Customers igen.
  3. Kontrollera värdena:
    • Consumed Units: 15 000+ tokens
    • Chargeable Units: 5 000 (10 000 kostnadsfria tokens har tillämpats)
    • Total Price: ~$0.05
Fliken Customers för mätaren som visar förbrukade enheter, debiterbara enheter och totalpris efter gratisnivån
Användningsbaserad billing fungerar. Kunderna debiteras för de tokens de använder.

Felsökning

Vanliga problem och lösningar:
Möjliga orsaker:
  • Händelsenamnet överensstämmer inte exakt med mätarkonfigurationen
  • Kund-ID:t finns inte i ditt konto
  • API-nyckeln är ogiltig eller har löpt ut
  • Problem med nätverksanslutningen
Lösningar:
  1. Kontrollera att händelsenamnet exakt överensstämmer med mätaren. Det är skiftlägeskänsligt: ai_chat_usage.
  2. Kontrollera att kund-ID:t finns i Dodo Payments-dashboarden.
  3. Testa API-nyckeln med ett enkelt API-anrop.
  4. Kontrollera serverloggarna efter fel.
Möjliga orsaker:
  • Modellen returnerar ingen användningsinformation
  • Felaktig SDK-version
Lösningar:
  1. Kontrollera om modellen returnerar användning:
  1. Uppdatera Blueprints-paketet: npm install @dodopayments/ingestion-blueprints@latest
Möjliga orsaker:
  • API-nyckeln tillhör det andra läget.
  • Filen .env innehåller extra blanksteg eller citattecken.
Lösningar:
  • En nyckel fungerar endast i det läge där den skapades. Använd en testlägesnyckel med DODO_PAYMENTS_ENVIRONMENT=test_mode och en live-lägesnyckel med live_mode.
  • Ta bort eventuella citattecken runt nycklarna i filen .env.
  • Generera en ny nyckel vid behov.
Behöver du hjälp?

Grattis! Du har byggt en AI-chattapp

Du har nu en fungerande AI-chattapplikation som spårar tokenanvändningen och debiterar kunderna för den genom Dodo Payments.

Läs mer

LLM Blueprint

Spåra LLM-tokenanvändning med LLM Ingestion Blueprint.

Ingestion Blueprints SDK

Fler exempel finns i GitHub-repositoriet.

Join Community

Få hjälp och dela dina projekt på Discord.
Senast ändrad 26 september 2026