- Alimente des conversations AI utilisant Google Gemini (AI SDK)
- Suit automatiquement l’utilisation des tokens (pas de code manuel)
- Facture les clients en fonction de la consommation réelle de tokens
- Inclut une belle interface de chat

Ce que nous construisons
Commençons par comprendre notre service de chat AI :- Service : Chat alimenté par AI utilisant Google Gemini (AI SDK)
- Modèle de tarification : Pay-per-token (0,01 $ par 1 000 tokens)
- Niveau gratuit : 10 000 tokens gratuits par client par mois
- Fonctionnalités : Historique des conversations, suivi automatique des tokens
- Un compte Dodo Payments
- Une clé API Google AI (Obtenez-en une sur aistudio)
- Node.js v16+ installé
Étape 1 : Créez votre compteur d’utilisation
Nous allons commencer par créer un compteur dans votre tableau de bord Dodo Payments qui suivra l’utilisation des tokens AI.Ouvrir la section Compteurs
- Connectez-vous à votre tableau de bord Dodo Payments
- Cliquez sur Produits dans la barre latérale gauche
- Cliquez sur Compteurs
- Cliquez sur le bouton Créer un compteur

Remplir les informations de base du compteur
AI Token Usage MeterDescription → Tracks token consumption from AI chat conversations using AI SDKNom de l’événement → ai_chat_usageConfigurer comment nous comptons les tokens
totalTokensUnité de mesure : Tapez → tokenstotalTokens dans chaque événement.Créez votre compteur
- Vérifiez que tous vos paramètres correspondent aux valeurs ci-dessus
- Cliquez sur Créer un compteur

Étape 2 : Obtenez vos clés API
Avant de construire l’application, rassemblons les clés API dont nous aurons besoin.Obtenez la clé API Dodo Payments
- Dans votre tableau de bord Dodo Payments, allez à Développeurs → Clés API
- Cliquez sur Créer une clé API
- Copiez la clé API - elle ressemblera à
test_abc123...
.env fichier plus tard.Obtenez la clé API Google AI
- Visitez aistudio.google.com
- Cliquez sur Obtenir la clé API
- Créez une nouvelle clé API ou utilisez une clé existante
- Copiez la clé
.env fichier.Étape 3 : Créez votre produit de facturation
Maintenant, nous devons créer un produit qui définit notre tarification (0,01 $ par 1 000 tokens avec 10 000 tokens gratuits). Cela connecte notre compteur à la facturation réelle.Naviguer vers Produits
- Dans votre tableau de bord Dodo Payments, cliquez sur Produits dans la barre latérale gauche
- Cliquez sur Créer un produit
- Sélectionnez Basé sur l’utilisation comme type de produit
Entrez les détails du produit
AI Chat ServiceDescription : → AI-powered chat service with automatic token-based billingImage du produit : Téléchargez une image pertinenteConnectez votre compteur
0 pour garantir que les clients ne soient facturés qu’en fonction de leur utilisation, sans frais de base.Maintenant, liez le compteur que vous venez de créer :- Faites défiler vers le bas jusqu’à la section Compteur associé
- Cliquez sur Ajouter des compteurs
- Dans le menu déroulant, sélectionnez “Compteur d’utilisation des tokens AI” (celui que vous avez créé plus tôt)
- Confirmez qu’il apparaît dans la configuration de votre produit
Définissez votre tarification
0.00001 (c’est 0,01 par token)Seuil gratuit : Entrez → 10000 (les clients obtiennent 10 000 tokens gratuits par mois)
Enregistrez votre produit
- Passez en revue tous vos paramètres :
- Nom : Service de chat AI
- Compteur : Compteur d’utilisation des tokens AI
- Prix : 0,01 $ par 1 000 tokens
- Niveau gratuit : 10 000 tokens
- Cliquez sur Enregistrer les modifications
Étape 4 : Effectuez un achat test
Avant de commencer à construire l’application, créons un client test en effectuant un achat.Obtenez votre lien de paiement
- Dans votre tableau de bord Dodo Payments, allez à Produits
- Trouvez votre produit “Service de chat AI”
- Cliquez sur le bouton Partager à côté de votre produit
- Copiez le lien de paiement qui apparaît
Complétez un achat test
- Ouvrez le lien de paiement dans un nouvel onglet de navigateur
- Entrez les détails de paiement test et complétez l’achat
Trouvez votre ID client
- Retournez à votre tableau de bord Dodo Payments
- Naviguez vers Ventes -> Clients dans la barre latérale gauche
- Trouvez le client que vous venez de créer (avec l’email test)
- Copiez l’ID client - il ressemblera à
cus_123
Étape 5 : Construisez l’application de chat
Maintenant que notre configuration de facturation est complète et qu’un client test a été créé. Construisons l’application de chat AI avec suivi automatique des tokens.Configurez votre projet
Installez les dépendances
Configurez TypeScript
tsconfig.json :package.json pour ajouter le type de module et les scripts :Créez la structure du projet
Configurez les variables d'environnement
.env à la racine de votre projet :Créez le serveur backend
src/server.ts et copiez ce code serveur complet :Étape 6 : Ajoutez l’interface de chat
Ajoutons maintenant une belle interface de chat avec un historique complet des conversations ! Créezpublic/index.html :
Étape 7 : Testez votre application de chat
Il est temps de tester notre application de chat AI et de voir la facturation en action ! Assurons-nous que tout fonctionne de bout en bout.Démarrez le serveur
- Vérifiez que votre
.envfichier contient toutes les clés API de l’étape 2 - Démarrez le serveur de développement :
Ouvrez l'interface de chat
- Ouvrez votre navigateur
- Naviguez vers
http://localhost:3000 - Vous devriez voir la belle interface de chat
CUSTOMER_ID dans server.ts avec votre ID client test réel de l’étape 4.Ayez votre première conversation
- “Qu’est-ce que l’intelligence artificielle ?”
- “Comment fonctionne l’apprentissage automatique ?”
- “Pouvez-vous expliquer les réseaux neuronaux ?”
Vérifiez votre tableau de bord Dodo Payments
- Ouvrez votre tableau de bord Dodo Payments
- Allez à Facturation d’utilisation → Compteur d’utilisation des tokens AI
- Cliquez sur l’onglet Événements
- Vous devriez voir vos événements de chat listés
- Noms des événements :
ai_chat_usage - ID client : Votre ID client test

Vérifiez le comptage des tokens
- Dans votre compteur, allez à l’onglet Clients
- Trouvez votre client test
- Vérifiez la colonne “Unités consommées” - elle devrait afficher le total des tokens utilisés

totalTokens !Testez le niveau gratuit
- Ayez plusieurs autres conversations (visez ~15 000+ tokens au total)
- Vérifiez à nouveau votre onglet Clients dans le tableau de bord du compteur
- Vous devriez maintenant voir :
- Unités consommées : 15 000+ tokens
- Unités facturables : 5 000 (10 000 tokens gratuits appliqués)
- Prix total : ~0,05 $

Dépannage
Problèmes courants et leurs solutions :Événements n'apparaissant pas dans le tableau de bord
Événements n'apparaissant pas dans le tableau de bord
- Le nom de l’événement ne correspond pas exactement à la configuration du compteur
- L’ID client n’existe pas dans votre compte
- La clé API est invalide ou expirée
- Problèmes de connectivité réseau
- Vérifiez que le nom de l’événement correspond exactement à la configuration du compteur (sensible à la casse :
ai_chat_usage) - Vérifiez que l’ID client existe dans le tableau de bord Dodo Payments
- Testez la clé API avec un appel API simple
- Vérifiez les journaux du serveur pour des messages d’erreur
Comptes de tokens affichant zéro
Comptes de tokens affichant zéro
- Le modèle ne renvoie pas d’informations d’utilisation
- Version SDK incorrecte
- Testez si le modèle renvoie l’utilisation :
- Mettez à jour vers la dernière version du SDK Blueprints :
npm install @dodopayments/ingestion-blueprints@latest
Erreur de clé API invalide
Erreur de clé API invalide
- Mauvaise clé API pour l’environnement
- Espaces ou guillemets supplémentaires dans le fichier
.env
- Assurez-vous que la clé de test commence par
test_, la clé en direct commence parlive_ - Supprimez les guillemets autour des clés dans le fichier
.env - Générez une nouvelle clé si nécessaire