Skip to main content
Per fare in modo che il tuo coding agent scriva l’integrazione, installa il Dodo Agent Plugin. Aggiunge le competenze e i server MCP di Dodo Payments a Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode.
Creerai PixelGen AI, un servizio di esempio per la generazione di immagini AI che addebita ai clienti ogni immagine con la fatturazione basata sull’utilizzo. Creerai il meter di fatturazione, il prodotto e il codice di esempio dell’applicazione che genera immagini e segnala ciascuna immagine a Dodo Payments man mano che viene generata.
Questo tutorial fornisce codice di esempio per un’applicazione da terminale. Puoi adattare il codice al tuo framework, ad esempio React, Vue o Angular, e al modo in cui la tua applicazione raccoglie l’input dell’utente.
Quando avrai finito, avrai un servizio di esempio funzionante che:
  • Genera immagini con il modello gpt-image-2.5-flare di OpenAI.
  • Tiene traccia di ogni generazione di immagini per la fatturazione.
  • Addebita ai clienti le immagini che generano.
  • Gestisce due livelli di qualità, medium e high.

Cosa creeremo

PixelGen AI funziona in questo modo:
  • Servizio: generazione di immagini AI con OpenAI Image API
  • Modello di prezzo: pagamento per immagine ($0.05 per immagine)
  • Piano gratuito: 10 immagini gratuite per cliente al mese
  • Opzioni di qualità: immagini di qualità medium e high, allo stesso prezzo
Prima di iniziare, ti servono:
  • Un account Dodo Payments.
  • Accesso all’API di OpenAI. OpenAI potrebbe richiedere la verifica dell’organizzazione API prima di consentirti di utilizzare i modelli GPT Image.
  • Node.js 22 o versione successiva e una conoscenza pratica di TypeScript e Node.js.

Passaggio 1: crea il tuo meter di utilizzo

Crea un meter nella dashboard di Dodo Payments che tenga traccia di ogni immagine generata dal servizio. Il meter conta gli eventi fatturabili.
Modulo Create Meter nella dashboard di Dodo Payments
Cosa stai creando: un meter chiamato “Image Generation Meter” che conta ogni generazione di immagini.
1

Open the Meters Section

  1. Accedi alla dashboard di Dodo Payments.
  2. Vai a Products → Meters nella barra laterale.
  3. Fai clic su Create Meter.
Si apre il modulo del meter.
2

Enter the Meter Details

Inserisci i dettagli per PixelGen AI:Meter Name: Image Generation MeterDescrizione: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generated
Il nome dell’evento image.generated deve corrispondere al nome dell’evento inviato dal codice dell’applicazione. I nomi degli eventi distinguono tra maiuscole e minuscole.
3

Configure How Images Are Counted

Imposta l’aggregazione, che controlla il modo in cui il meter combina gli eventi:Aggregation Type: CountMeasurement Unit: images
Count fattura per immagine generata, non in base alle dimensioni o al tempo di generazione. Ogni immagine generata correttamente corrisponde a un’unità fatturabile.
4

Add Quality Filtering

Filtro degli eventi nel modulo del meter con due condizioni di qualità unite da OR
Conta solo le immagini reali, non le esecuzioni di test o gli eventi non validi:
  1. Attiva Enable Event Filtering.
  2. Imposta la logica di corrispondenza su OR, in modo che un evento venga conteggiato quando una qualsiasi condizione corrisponde.
  3. Aggiungi la prima condizione:
    • Chiave: quality
    • Operatore: equals
    • Valore: medium
  4. Fai clic su Add condition e aggiungi la seconda:
    • Chiave: quality
    • Operatore: equals
    • Valore: high
Con questo filtro, il meter conta solo gli eventi la cui qualità è medium o high e ignora gli eventi di test o non validi.
5

Create Your Meter

  1. Verifica che ogni impostazione corrisponda ai valori indicati sopra. Non puoi modificare un meter dopo averlo creato.
  2. Fai clic su Create Meter.
Meter creato. Il “Image Generation Meter” è pronto per contare le generazioni di immagini. Ora collegalo a un prodotto di fatturazione.

Passaggio 2: crea il tuo prodotto di fatturazione

Crea un prodotto che definisca il prezzo: $0.05 per immagine, con 10 immagini gratuite. Il prodotto collega il meter alla fatturazione.
Cosa stai creando: un prodotto chiamato “PixelGen AI - Image Generation” che addebita $0.05 per immagine dopo le prime 10 immagini gratuite di ogni mese.
1

Navigate to Products

  1. Nella dashboard di Dodo Payments, fai clic su Products nella barra laterale.
  2. Fai clic su Add Product.
  3. In Pricing Type, seleziona Usage Based Billing.
Con questo tipo di prezzo, Dodo Payments fattura in base all’utilizzo del meter invece che a un prezzo di abbonamento fisso.
2

Enter Product Details

Inserisci questi valori:Product Name: PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: carica un’immagine chiara e pertinente.
Il nome e la descrizione vengono visualizzati sulle fatture dei clienti.
3

Connect Your Meter

Prezzi Usage Based Billing nel modulo del prodotto con la sezione Associated Meters
Verifica che il tipo di prezzo del prodotto sia Usage Based Billing.Imposta Price su 0, in modo che i clienti paghino solo per l’utilizzo, senza costi fissi.Quindi collega il meter che hai creato:
  1. Scorri fino alla sezione Associated Meters.
  2. Fai clic su Add meters.
  3. Seleziona “Image Generation Meter” dal menu a discesa.
  4. Verifica che il meter venga visualizzato nella configurazione del prodotto.
Il meter è collegato al prodotto.
4

Set Your Pricing

Definisci il prezzo per immagine e il livello gratuito:
Prezzi del meter con i campi per il prezzo per unità e la soglia gratuita
Price per unit: 0.05, ovvero $0.05 per immagine.Free Threshold: 10. Ogni cliente riceve 10 immagini gratuite al mese.
Come funziona la fatturazione: un cliente che genera 25 immagini in un mese paga 15 immagini (25 − 10 gratuite). 15 × $0.05 = $0.75.
5

Save Your Product

  1. Esamina le impostazioni:
    • Name: PixelGen AI - Image Generation
    • Meter: Image Generation Meter
    • Price: $0.05 per image
    • Free tier: 10 images
  2. Fai clic su Save Changes.
Prodotto creato. La fatturazione è configurata e ai clienti vengono addebitate le immagini che generano.

Passaggio 3: effettua un acquisto di test

Acquista una volta il prodotto in modalità test. L’acquisto crea il cliente per il quale l’app invia gli eventi di utilizzo.
1

Get Your Payment Link

  1. Nella dashboard di Dodo Payments, vai a Products.
  2. Trova il prodotto “PixelGen AI - Image Generation”.
  3. Fai clic su Share accanto al prodotto.
  4. Copia il link di pagamento.
Il link di pagamento è simile a https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1.
2

Complete a Test Purchase

  1. Apri il link di pagamento in una nuova scheda del browser.
  2. Inserisci i dati di pagamento di test e completa l’acquisto.
Dopo che il pagamento è andato a buon fine, l’acquisto crea un cliente. Il codice dell’applicazione utilizza l’ID di quel cliente.
3

Find Your Customer ID

  1. Torna alla dashboard di Dodo Payments.
  2. Vai a Sales → Customers nella barra laterale.
  3. Trova il cliente che hai creato usando il suo indirizzo email di test.
  4. Copia l’ID del cliente. È simile a cus_abc123def456.
Salva questo ID cliente. L’applicazione di esempio lo imposta nel codice, così ogni evento viene registrato per questo cliente.

Passaggio 4: crea l’applicazione di esempio

Dopo aver configurato la fatturazione e creato un cliente di test, crea l’applicazione di esempio PixelGen AI. Genera un’immagine e la segnala a Dodo Payments ai fini della fatturazione.
L’esempio chiama il modello gpt-image-2.5-flare di OpenAI tramite Image API. Image API restituisce dati immagine codificati in base64, quindi l’esempio salva ogni immagine come file PNG. La parte relativa a Dodo Payments (il meter, il prodotto e l’evento di utilizzo image.generated) non dipende dal modello.
1

Set Up Your Project

Crea una directory e inizializza il progetto:
2

Install Dependencies

Installa i pacchetti:
3

Create the Main Application

Crea un file chiamato index.ts e incolla il codice dell’applicazione riportato di seguito.
L’applicazione PixelGen AI completa con la fatturazione, oltre al relativo .env e package.json:

Passaggio 5: testa l’applicazione di esempio

Testa PixelGen AI dall’inizio alla fine e osserva l’utilizzo arrivare a Dodo Payments.
Cosa stai testando: generi alcune immagini, verifichi che gli eventi raggiungano Dodo Payments e controlli il calcolo della fatturazione.
1

Set Up Your Environment

  1. Crea un file .env nella directory pixelgen-ai.
  2. Aggiungi le tue chiavi API:
  1. Installa le dipendenze ed esegui l’app:
Usa chiavi API reali e sostituisci l’ID cliente hardcoded in index.ts con l’ID cliente del Passaggio 3.
2

Generate Your First Test Image

Quando l’app si avvia, stampa:
Inserisci questo prompt: “A cute robot painting a landscape”L’output è simile a questo. Le righe di debug della richiesta stampate da sendUsageEvent sono omesse:
Se l’output include “Usage event sent successfully”, l’integrazione della fatturazione funziona.
3

Generate a Few More Images

Genera altre due o tre immagini per testare più eventi. Esegui npm start una volta per immagine, usando questi prompt:
  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”
Ogni volta, verifica la presenza del messaggio “Usage event sent successfully”.
4

Check Your Dodo Payments Dashboard

Verifica che Dodo Payments riceva gli eventi:
  1. Apri la dashboard di Dodo Payments.
  2. Vai a Products → Meters e apri Image Generation Meter.
  3. Seleziona la scheda Events.
  4. Trova gli eventi di generazione delle immagini nell’elenco.
Cosa cercare:
  • Nome dell’evento: image.generated
  • ID cliente: l’ID del tuo cliente di test
L’elenco contiene un evento per ogni immagine generata.
5

Verify Billing Calculations

Controlla il conteggio dell’utilizzo:
Scheda Customers del meter che mostra le unità consumate per cliente
  1. Nel meter, seleziona la scheda Customers.
  2. Trova il tuo cliente di test.
  3. Controlla la colonna Consumed Units.
6

Test the Billing Threshold

Supera il livello gratuito per visualizzare la fatturazione:
  1. Genera altre 8 immagini, per un totale di 12.
  2. Apri di nuovo la scheda Customers del meter.
  3. Controlla i valori:
    • Consumed Units: 12
    • Chargeable Units: 2 (12 − 10 gratuite)
    • Total Price: $0.10
La fatturazione basata sull’utilizzo funziona. Ai clienti vengono addebitate le immagini che generano.

Risoluzione dei problemi

Problemi comuni e relative soluzioni:
Possibili cause:
  • Il nome dell’evento non corrisponde esattamente alla configurazione del meter
  • L’ID cliente non esiste nel tuo account
  • La chiave API non è valida o è scaduta
  • Problemi di connettività di rete
Soluzioni:
  1. Verifica che il nome dell’evento corrisponda esattamente al meter. Distingue tra maiuscole e minuscole.
  2. Verifica che l’ID cliente esista in Dodo Payments.
  3. Testa la chiave API con una semplice chiamata API.
  4. Controlla la connettività di rete e le impostazioni del firewall.

Congratulazioni! Hai creato PixelGen AI

Hai creato un generatore di immagini AI di esempio con fatturazione basata sull’utilizzo:

Usage Meter

Un “Image Generation Meter” che conta ogni evento di generazione delle immagini.

Billing Product

Prezzi di $0.05 per immagine, con 10 immagini gratuite al mese.

AI Application

Un’app TypeScript che genera immagini con l’API per immagini di OpenAI.

Automated Billing

Il monitoraggio degli eventi segnala ogni immagine man mano che viene generata, così ai clienti viene addebitato l’utilizzo.
Ultima modifica il 26 settembre 2026