Skip to main content
Pour que votre agent de codage écrive l’intégration, installez le Dodo Agent Plugin. Il ajoute les compétences Dodo Payments et les serveurs MCP à Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro et OpenCode.
Vous allez créer PixelGen AI, un service d’exemple de génération d’images IA qui facture les clients par image avec une facturation basée sur l’utilisation. Vous allez créer le meter de facturation, le produit et le code d’application d’exemple qui génère des images et signale chacune d’elles à Dodo Payments au fur et à mesure.
Ce tutoriel fournit un exemple de code pour une application de terminal. Vous pouvez adapter le code à votre framework, comme React, Vue ou Angular, ainsi qu’à la manière dont votre application recueille les entrées utilisateur.
Lorsque vous aurez terminé, vous disposerez d’un service d’exemple fonctionnel qui :
  • Génère des images avec le modèle gpt-image-2.5-flare d’OpenAI.
  • Suit chaque génération d’image à des fins de facturation.
  • Facture les clients pour les images qu’ils génèrent.
  • Gère deux niveaux de qualité, medium et high.

Ce que nous allons créer

PixelGen AI fonctionne comme suit :
  • Service : génération d’images avec l’Image API d’OpenAI
  • Modèle tarifaire : paiement par image ($0.05 par image)
  • Niveau gratuit : 10 images gratuites par client et par mois
  • Options de qualité : images de qualité medium et high, au même prix
Avant de commencer, vous avez besoin des éléments suivants :
  • Un compte Dodo Payments.
  • Un accès à l’API OpenAI. OpenAI peut exiger la vérification de l’organisation API avant que vous puissiez utiliser les modèles GPT Image.
  • Node.js 22 ou version ultérieure, ainsi qu’une bonne connaissance de TypeScript et de Node.js.

Étape 1 : créer votre meter d’utilisation

Créez un meter dans le dashboard Dodo Payments qui suit chaque image générée par le service. Le meter compte les événements facturables.
Formulaire Create Meter dans le dashboard Dodo Payments
Ce que vous allez créer : un meter nommé “Image Generation Meter” qui compte chaque génération d’image.
1

Open the Meters Section

  1. Connectez-vous au dashboard Dodo Payments.
  2. Accédez à Products → Meters dans la barre latérale.
  3. Cliquez sur Create Meter.
Le formulaire du meter s’ouvre.
2

Enter the Meter Details

Saisissez les informations de PixelGen AI :Meter Name : Image Generation MeterDescription : Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name : image.generated
Le nom d’événement image.generated doit correspondre au nom d’événement envoyé par le code de l’application. Les noms d’événements sont sensibles à la casse.
3

Configure How Images Are Counted

Définissez l’agrégation, qui contrôle la manière dont le meter combine les événements :Aggregation Type : CountMeasurement Unit : images
Count facture chaque image générée, et non selon sa taille ou son temps de génération. Chaque image générée avec succès correspond à une unité facturable.
4

Add Quality Filtering

Filtrage des événements dans le formulaire du meter avec deux conditions de qualité reliées par OR
Comptez uniquement les images réelles, et non les exécutions de test ou les événements malformés :
  1. Activez Enable Event Filtering.
  2. Définissez la logique de correspondance sur OR, afin qu’un événement soit comptabilisé lorsqu’une condition correspond.
  3. Ajoutez la première condition :
    • Clé : quality
    • Opérateur : equals
    • Valeur : medium
  4. Cliquez sur Add condition et ajoutez la seconde condition :
    • Clé : quality
    • Opérateur : equals
    • Valeur : high
Avec ce filtre, le compteur comptabilise uniquement les événements dont la qualité est medium ou high, et ignore les événements de test ou mal formés.
5

Create Your Meter

  1. Vérifiez que chaque paramètre correspond aux valeurs ci-dessus. Vous ne pouvez pas modifier un meter après sa création.
  2. Cliquez sur Create Meter.
Meter créé. Le “Image Generation Meter” est prêt à compter les générations d’images. Ensuite, connectez-le à un produit de facturation.

Étape 2 : créer votre produit de facturation

Créez un produit qui définit le tarif : $0.05 par image, avec 10 images gratuites. Le produit relie le meter à la facturation.
Ce que vous allez créer : un produit appelé “PixelGen AI - Image Generation” qui facture $0.05 par image après les 10 premières images gratuites chaque mois.
1

Navigate to Products

  1. Dans le dashboard Dodo Payments, cliquez sur Products dans la barre latérale.
  2. Cliquez sur Add Product.
  3. Sous Pricing Type, sélectionnez Usage Based Billing.
Avec ce type de tarification, Dodo Payments facture selon l’utilisation du meter plutôt qu’avec un prix d’abonnement fixe.
2

Enter Product Details

Saisissez ces valeurs :Product Name : PixelGen AI - Image GenerationDescription : AI-powered image generation service with pay-per-use billingProduct Image : importez une image claire et pertinente.
Le nom et la description apparaissent sur les factures client.
3

Connect Your Meter

Tarification Usage Based Billing dans le formulaire du produit avec la section Associated Meters
Vérifiez que le type de tarification du produit est Usage Based Billing.Définissez le Price sur 0, afin que les clients paient uniquement selon leur utilisation, sans frais de base.Associez ensuite le meter que vous avez créé :
  1. Faites défiler jusqu’à la section Associated Meters.
  2. Cliquez sur Add meters.
  3. Sélectionnez “Image Generation Meter” dans le menu déroulant.
  4. Vérifiez que le meter apparaît dans la configuration du produit.
Le meter est connecté au produit.
4

Set Your Pricing

Définissez le prix par image et l’offre gratuite :
Tarification du meter avec les champs du prix par unité et du seuil gratuit
Price per unit : 0.05, soit $0.05 par image.Free Threshold : 10. Chaque client bénéficie de 10 images gratuites par mois.
Fonctionnement de la facturation : un client qui génère 25 images au cours d’un mois paie pour 15 images (25 − 10 gratuites). 15 × $0.05 = $0.75.
5

Save Your Product

  1. Vérifiez les paramètres :
    • Name : PixelGen AI - Image Generation
    • Meter : Image Generation Meter
    • Price : $0.05 par image
    • Offre gratuite : 10 images
  2. Cliquez sur Save Changes.
Produit créé. La facturation est configurée et les clients sont facturés pour les images qu’ils génèrent.

Étape 3 : effectuer un achat de test

Achetez une fois le produit en mode test. L’achat crée le client pour lequel l’application envoie les événements d’utilisation.
1

Get Your Payment Link

  1. Dans le dashboard Dodo Payments, accédez à Products.
  2. Recherchez le produit “PixelGen AI - Image Generation”.
  3. Cliquez sur Share à côté du produit.
  4. Copiez le lien de paiement.
Le lien de paiement ressemble à https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1.
2

Complete a Test Purchase

  1. Ouvrez le lien de paiement dans un nouvel onglet du navigateur.
  2. Saisissez les informations de paiement de test et finalisez l’achat.
Une fois le paiement effectué, l’achat crée un client. Le code de l’application utilise l’identifiant de ce client.
3

Find Your Customer ID

  1. Retournez au dashboard Dodo Payments.
  2. Accédez à Sales → Customers dans la barre latérale.
  3. Recherchez le client que vous avez créé à l’aide de son adresse e-mail de test.
  4. Copiez l’identifiant du client. Il ressemble à cus_abc123def456.
Enregistrez cet identifiant client. L’application d’exemple le définit dans le code afin que chaque événement soit enregistré pour ce client.

Étape 4 : créer l’application d’exemple

Une fois la facturation configurée et un client de test créé, créez l’application PixelGen AI d’exemple. Elle génère une image et la signale à Dodo Payments pour la facturation.
L’exemple appelle le modèle gpt-image-2.5-flare d’OpenAI via l’Image API. L’Image API renvoie les données de l’image encodées en base64 ; l’exemple enregistre donc chaque image dans un fichier PNG. La partie Dodo Payments (le compteur, le produit et l’événement d’utilisation image.generated) ne dépend pas du modèle.
1

Set Up Your Project

Créez un répertoire et initialisez le projet :
2

Install Dependencies

Installez les packages :
3

Create the Main Application

Créez un fichier appelé index.ts et collez-y le code de l’application ci-dessous.
L’application PixelGen AI complète avec la facturation, ainsi que les .env et package.json correspondants :

Étape 5 : tester votre application d’exemple

Testez PixelGen AI de bout en bout et observez l’utilisation parvenir à Dodo Payments.
Ce que vous testez : vous générez quelques images, vérifiez que les événements parviennent à Dodo Payments et contrôlez le calcul de la facturation.
1

Set Up Your Environment

  1. Créez un fichier .env dans le répertoire pixelgen-ai.
  2. Ajoutez vos clés API :
  1. Installez les dépendances et exécutez l’application :
Utilisez de vraies clés API et remplacez l’identifiant client codé en dur dans index.ts par l’identifiant client de l’étape 3.
2

Generate Your First Test Image

Au démarrage de l’application, le message suivant s’affiche :
Saisissez ce prompt : “A cute robot painting a landscape”La sortie ressemble à ceci. Les lignes de debug de la requête qu’affiche sendUsageEvent sont omises :
Si la sortie contient “Usage event sent successfully”, l’intégration de facturation fonctionne.
3

Generate a Few More Images

Générez deux ou trois images supplémentaires pour tester plusieurs événements. Exécutez npm start une fois par image, avec les prompts suivants :
  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”
À chaque fois, vérifiez la présence du message “Usage event sent successfully”.
4

Check Your Dodo Payments Dashboard

Vérifiez que Dodo Payments reçoit les événements :
  1. Ouvrez le dashboard Dodo Payments.
  2. Accédez à Products → Meters et ouvrez Image Generation Meter.
  3. Sélectionnez l’onglet Events.
  4. Recherchez vos événements de génération d’images dans la liste.
Éléments à vérifier :
  • Nom d’événement : image.generated
  • ID client : l’ID de votre client de test
La liste contient un événement pour chaque image que vous avez générée.
5

Verify Billing Calculations

Vérifiez le nombre d’utilisations :
Onglet Customers du meter affichant les unités consommées par client
  1. Dans le meter, sélectionnez l’onglet Customers.
  2. Recherchez votre client de test.
  3. Vérifiez la colonne Consumed Units.
6

Test the Billing Threshold

Dépassez l’offre gratuite pour voir la facturation :
  1. Générez 8 images supplémentaires, soit 12 au total.
  2. Ouvrez à nouveau l’onglet Customers du meter.
  3. Vérifiez les valeurs :
    • Consumed Units : 12
    • Chargeable Units : 2 (12 − 10 gratuites)
    • Total Price : $0.10
La facturation basée sur l’utilisation fonctionne. Les clients sont facturés pour les images qu’ils génèrent.

Résolution des problèmes

Problèmes courants et solutions :
Causes possibles :
  • Le nom d’événement ne correspond pas exactement à la configuration du meter
  • L’ID client n’existe pas dans votre compte
  • La clé API est invalide ou expirée
  • Problèmes de connectivité réseau
Solutions :
  1. Vérifiez que le nom d’événement correspond exactement au meter. Il est sensible à la casse.
  2. Vérifiez que l’ID client existe dans Dodo Payments.
  3. Testez la clé API avec un simple appel API.
  4. Vérifiez la connectivité réseau et les paramètres du pare-feu.

Félicitations ! Vous avez créé PixelGen AI

Vous avez créé un générateur d’images IA d’exemple avec une facturation basée sur l’utilisation :

Usage Meter

Un “Image Generation Meter” qui compte chaque événement de génération d’image.

Billing Product

Un tarif de $0.05 par image, avec 10 images gratuites par mois.

AI Application

Une application TypeScript qui génère des images avec l’API d’images OpenAI.

Automated Billing

Un suivi des événements qui signale chaque image au moment de sa génération afin que les clients soient facturés selon leur utilisation.
Dernière modification le 26 septembre 2026