- Permite mantener conversaciones con IA usando Google Gemini (AI SDK)
- Realiza un seguimiento automático del uso de tokens (sin código manual)
- Cobra a los clientes según el consumo real de tokens
- Incluye una atractiva interfaz de chat

Lo que vamos a crear
Comencemos por comprender nuestro servicio de chat con IA:- Servicio: chat con tecnología de IA usando Google Gemini (AI SDK)
- Modelo de precios: pago por token ($0.01 por cada 1,000 tokens)
- Nivel gratuito: 10,000 tokens gratuitos por cliente al mes
- Funciones: historial de conversaciones y seguimiento automático de tokens
- Una cuenta de Dodo Payments
- Una clave de API de Google AI (Obtén una en aistudio)
- Node.js v16+ instalado
Paso 1: Crea tu medidor de uso
Comenzaremos creando un medidor en tu panel de control de Dodo Payments que realizará un seguimiento del uso de tokens de IA.Open the Meters section
- Inicia sesión en tu panel de control de Dodo Payments
- Haz clic en Products en la barra lateral izquierda
- Haz clic en Meters
- Haz clic en el botón Create Meter

Fill in the basic meter information
AI Token Usage MeterDescripción → Tracks token consumption from AI chat conversations using AI SDKNombre del evento → ai_chat_usageConfigure how we count tokens
totalTokensUnidad de medición: escribe → tokenstotalTokens en cada evento.Create your meter
- Comprueba que todos los ajustes coincidan con los valores anteriores
- Haz clic en Create Meter

Paso 2: Obtén tus claves de API
Antes de crear la aplicación, reunamos las claves de API que necesitaremos.Get Dodo Payments API Key
- En el panel de control de Dodo Payments, ve a Developers → API Keys
- Haz clic en Create API Key
- Copia la clave de API; tendrá un aspecto similar a
test_abc123...
.env.Get Google AI API Key
- Visita aistudio.google.com
- Haz clic en Get API Key
- Crea una clave de API nueva o usa una existente
- Copia la clave
.env.Paso 3: Crea tu producto de facturación
Ahora debemos crear un producto que defina nuestros precios ($0.01 por cada 1,000 tokens con 10,000 tokens gratuitos). Esto conecta nuestro medidor con la facturación real.Navigate to Products
- En el panel de control de Dodo Payments, haz clic en Products en la barra lateral izquierda
- Haz clic en Create Product
- Selecciona Usage-Based como tipo de producto
Enter product details
AI Chat ServiceDescripción: → AI-powered chat service with automatic token-based billingImagen del producto: sube una imagen relevanteConnect your meter
0 para asegurarte de que los clientes solo paguen según su uso, sin ninguna tarifa base.Ahora, vincula el medidor que acabas de crear:- Desplázate hasta la sección Associated Meter
- Haz clic en Add Meters
- En el menú desplegable, selecciona “AI Token Usage Meter” (el que creaste anteriormente)
- Confirma que aparezca en la configuración de tu producto
Set your pricing
0.00001 (esto equivale a 0.00001 por token)Umbral gratuito: introduce → 10000 (los clientes reciben 10,000 tokens gratuitos al mes)
Save your product
- Revisa todos los ajustes:
- Nombre: AI Chat Service
- Medidor: AI Token Usage Meter
- Precio: $0.01 por cada 1,000 tokens
- Nivel gratuito: 10,000 tokens
- Haz clic en Save Changes
Paso 4: Realiza una compra de prueba
Antes de comenzar a crear la aplicación, creemos un cliente de prueba realizando una compra.Get your payment link
- En el panel de control de Dodo Payments, ve a Products
- Busca el producto “AI Chat Service”
- Haz clic en el botón Share junto al producto
- Copia el enlace de pago que aparece
Complete a test purchase
- Abre el enlace de pago en una pestaña nueva del navegador
- Introduce los datos de pago de prueba y completa la compra
Find your customer ID
- Vuelve al panel de control de Dodo Payments
- Ve a Sales -> Customers en la barra lateral izquierda
- Busca el cliente que acabas de crear (con el correo electrónico de prueba)
- Copia el ID de cliente; tendrá un aspecto similar a
cus_123
Paso 5: Crea la aplicación de chat
Ahora que hemos completado la configuración de facturación y creado un cliente de prueba, creemos la aplicación de chat con IA y seguimiento automático de tokens.Set up your project
Install dependencies
Configure TypeScript
tsconfig.json:package.json para añadir el tipo de módulo y los scripts:Create project structure
Set up environment variables
.env en la raíz del proyecto:Create the backend server
src/server.ts y copia este código completo del servidor:Paso 6: Añade la interfaz de chat
Ahora añadamos una atractiva interfaz de chat con el historial completo de conversaciones. Creapublic/index.html:
Paso 7: Prueba tu aplicación de chat
¡Es hora de probar nuestra aplicación de chat con IA y ver la facturación en acción! Asegurémonos de que todo funciona de principio a fin.Start the server
- Comprueba que tu archivo
.envcontenga todas las claves de API del Paso 2 - Inicia el servidor de desarrollo:
Open the chat interface
- Abre el navegador
- Ve a
http://localhost:3000 - Deberías ver la atractiva interfaz de chat
CUSTOMER_ID en server.ts con el ID de tu cliente de prueba del Paso 4.Have your first conversation
- “¿Qué es la inteligencia artificial?”
- “¿Cómo funciona el aprendizaje automático?”
- “¿Puedes explicar las redes neuronales?”
Check your Dodo Payments dashboard
- Abre el panel de control de Dodo Payments
- Ve a Usage Billing → AI Token Usage Meter
- Haz clic en la pestaña Events
- Deberías ver tus eventos de chat en la lista
- Nombres de eventos:
ai_chat_usage - ID de cliente: el ID de tu cliente de prueba

Verify token counting
- En tu medidor, ve a la pestaña Customers
- Busca tu cliente de prueba
- Comprueba la columna “Consumed Units”; debería mostrar el total de tokens utilizados

totalTokens!Test the free tier
- Mantén varias conversaciones más (intenta alcanzar un total de aproximadamente 15,000 tokens o más)
- Vuelve a consultar la pestaña Customers del panel del medidor
- Ahora deberías ver:
- Unidades consumidas: más de 15,000 tokens
- Unidades facturables: 5,000 (se aplicaron 10,000 tokens gratuitos)
- Precio total: aproximadamente $0.05

Solución de problemas
Problemas habituales y sus soluciones:Events not appearing in dashboard
Events not appearing in dashboard
- El nombre del evento no coincide exactamente con la configuración del medidor
- El ID de cliente no existe en tu cuenta
- La clave de API no es válida o ha caducado
- Problemas de conectividad de red
- Comprueba que el nombre del evento coincida exactamente con la configuración del medidor (distingue entre mayúsculas y minúsculas:
ai_chat_usage) - Comprueba que el ID de cliente exista en el panel de control de Dodo Payments
- Prueba la clave de API con una llamada de API sencilla
- Comprueba los registros del servidor para ver los mensajes de error
Token counts showing zero
Token counts showing zero
- El modelo no devuelve información de uso
- La versión del SDK es incorrecta
- Comprueba si el modelo devuelve información de uso:
- Actualiza a la versión más reciente de Blueprints SDK:
npm install @dodopayments/ingestion-blueprints@latest
API key invalid error
API key invalid error
- La clave de API no corresponde al entorno
- Hay espacios o comillas adicionales en el archivo
.env
- Asegúrate de que la clave de prueba comience por
test_y la clave activa porlive_ - Elimina las comillas que rodeen las claves en el archivo
.env - Genera una clave nueva si es necesario