Este tutorial ofrece código de muestra para una aplicación basada en terminal. Puedes adaptar este código a tu framework específico (React, Vue, Angular, etc.) y personalizar el método de ingreso del usuario según las necesidades de tu aplicación.
- Genera imágenes utilizando la API DALL-E de OpenAI
- Rastrea cada generación de imagen para la facturación
- Cobra a los clientes automáticamente según el uso
- Maneja diferentes niveles de calidad (estándar vs HD)
Lo que Estamos Construyendo
Comencemos por entender nuestro servicio PixelGen AI:- Servicio: Generación de imágenes AI utilizando la API DALL-E de OpenAI
- Modelo de Precios: Pago por imagen ($0.05 por imagen)
- Nivel Gratuito: 10 imágenes gratuitas por cliente por mes
- Opciones de Calidad: Imágenes estándar y HD (mismo precio por simplicidad)
Antes de comenzar, asegúrate de tener:
- Una cuenta de Dodo Payments
- Acceso a la API de OpenAI
- Conocimientos básicos de TypeScript/Node.js
Paso 1: Crea Tu Medidor de Uso
Comenzaremos creando un medidor en tu panel de Dodo Payments que rastreará cada imagen que genere nuestro servicio. Piensa en esto como el “contador” que rastrea eventos facturables.
Open the Meters section
- Inicia sesión en el panel de Dodo Payments
- Haz clic en Meters en la barra lateral izquierda
- Haz clic en el botón Create Meter
Fill in the basic meter information
Ahora ingresaremos los detalles específicos para nuestro servicio PixelGen AI:Meter Name: Copia y pega exactamente esto →
Image Generation MeterDescription: Copia esto → Tracks each AI image generation request made by customers using our DALL-E powered serviceEvent Name: Esto es crucial - copia exactamente → image.generatedConfigure how we count images
Configura la agregación (cómo el medidor cuenta nuestros eventos):Tipo de Agregación: Selecciona Contar del menú desplegableMeasurement Unit: Escribe →
imagesUsamos “Count” porque queremos facturar por cada imagen generada, no por tamaño o duración. Cada imagen exitosa = 1 unidad facturable.
Add quality filtering

- Activa Event Filtering: cambia esto a ON
- Filter Logic: Selecciona OR (esto significa “contar si CUALQUIERA de estas condiciones es verdadera”)
- Agrega la primera condición:
- Property Key:
quality - Comparator:
equals - Value:
standard
- Property Key:
- Haz clic en “Add Condition” para la segunda:
- Property Key:
quality - Comparator:
equals - Value:
hd
- Property Key:
Paso 2: Crea Tu Producto de Facturación
Ahora necesitamos crear un producto que defina nuestros precios ($0.05 por imagen con 10 imágenes gratuitas). Esto conecta nuestro medidor a la facturación real.Navigate to Products
- En tu panel 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
Completa estos valores exactos para nuestro servicio PixelGen AI:Product Name: Copia esto →
PixelGen AI - Image GenerationDescription: Copia esto → AI-powered image generation service with pay-per-use billingImagen del Producto: Sube una imagen clara y relevante.Aparecerán en las facturas del cliente, así que haz que sean claros y profesionales.
Connect your meter

0 para asegurar que los clientes solo paguen según su uso, sin cuota base.Ahora, vincula el medidor que acabas de crear:- Desplázate hacia abajo a la sección Medidor Asociado
- Haz clic en Agregar Medidores
- Desde el menú desplegable, selecciona “Medidor de Generación de Imágenes” (el que creaste anteriormente)
- Confirma que aparece en la configuración de tu producto
Tu medidor ya está conectado con éxito a este producto.
Set your pricing
Aquí definimos nuestro modelo de negocio:
Price Per Unit: Ingresa →

0.05 (esto es $0.05 por imagen)Free Threshold: Ingresa → 10 (los clientes obtienen 10 imágenes gratuitas al mes)Save your product
- Revisa todos tus ajustes:
- Nombre: PixelGen AI - Image Generation
- Medidor: Image Generation Meter
- Precio: $0.05 por imagen
- Nivel gratuito: 10 imágenes
- Haz clic en Save Changes
¡Producto creado! Tu facturación ya está configurada. Los clientes serán cobrados automáticamente según su uso de generación de imágenes.
Paso 3: Realiza una Compra de Prueba
Antes de comenzar a recibir eventos de uso, necesitamos realizar una compra de prueba.Get your payment link
- En tu panel de Dodo Payments, ve a Products
- Busca tu producto “PixelGen AI - Image Generation”
- Haz clic en el botón Share junto a tu producto
- Copia el enlace de pago que aparece
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1Complete a test purchase
- Abre el enlace de pago en una nueva pestaña del navegador
- Ingresa los datos de pago de prueba y completa la compra.
Después del pago exitoso, tendrás un ID de cliente que usaremos en el código de nuestra aplicación.
Find your customer ID
- Regresa a tu panel de Dodo Payments
- Navega a Customers en la barra lateral izquierda
- Encuentra el cliente que acabas de crear (con el correo de prueba)
- Copia el ID del cliente: se verá como
cus_abc123def456
Guarda este ID de cliente: lo codificaremos en nuestro código de muestra para asegurarnos de que los eventos se rastreen correctamente.
Paso 4: Construye la Aplicación de Ejemplo
Ahora tenemos nuestra configuración de facturación completa y un cliente de prueba creado. Vamos a construir la aplicación de ejemplo PixelGen AI que genera imágenes y rastrea automáticamente el uso para la facturación.
Aquí está la aplicación completa de PixelGen AI con facturación integrada:
Paso 5: Prueba Tu Aplicación de Ejemplo
¡Es hora de probar nuestro servicio de ejemplo PixelGen AI y ver la facturación en acción! Asegurémonos de que todo funcione de extremo a extremo.Set up your environment
Primero, asegúrate de tener todo configurado:
- Crea un archivo
.enven tu directoriopixelgen-ai - Agrega tus claves de API reales:
- Instala las dependencias y ejecuta la aplicación:
Generate your first test image
Cuando la aplicación inicie, verás:Prueba este prompt: “Un robot lindo pintando un paisaje”Deberías ver una salida como esta:
Si ves “Usage event sent successfully”, ¡tu integración de facturación está funcionando!
Generate a few more images
Generemos 2-3 imágenes más para probar múltiples eventos. Intenta estos prompts:
- “Un atardecer sobre montañas con nubes moradas”
- “Una máquina de café steampunk en una cocina victoriana”
- “Un dragón amigable leyendo un libro en una biblioteca”
Check your Dodo Payments dashboard
Ahora verifiquemos que los eventos se están recibiendo:
- Abre tu panel de Dodo Payments
- Ve a Facturación por Uso → *Medidores → Medidor de Generación de Imágenes
- Haz clic en la pestaña Eventos
- Deberías ver tus eventos de generación de imágenes listados
- Nombres de eventos:
image.generated - ID de cliente: Tu ID de cliente de prueba
¡Deberías ver un evento por cada imagen generada!
Verify billing calculations
Verifiquemos si el conteo de uso está funcionando:

- En tu medidor, ve a la pestaña Clientes
- Encuentra tu cliente de prueba
- Verifica la columna “Unidades Consumidas”
Test the billing threshold
Superemos la capa gratuita para ver la facturación en acción:
- Genera 8 imágenes más (para alcanzar un total de 12)
- Verifica tu panel de medidor nuevamente
- Ahora deberías ver:
- Unidades consumidas: 12
- Unidades facturables: 2 (12 - 10 gratuitas)
- Monto de facturación: $0.10
¡Éxito! Tu facturación basada en uso funciona perfectamente. Los clientes se cobrarán automáticamente según su uso real de generación de imágenes.
Solución de Problemas
Problemas comunes y sus soluciones:Events not appearing in dashboard
Events not appearing in dashboard
Causas posibles:
- 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 es inválida o ha expirado
- Problemas de conectividad de red
- Verifica que el nombre del evento coincida exactamente con la configuración del medidor (distingue mayúsculas/minúsculas)
- Comprueba que el ID del cliente exista en Dodo Payments
- Prueba la clave de API con una llamada simple a la API
- Revisa la conectividad de red y la configuración del firewall
¡Felicidades! Has Construido PixelGen AI
¡Has creado exitosamente un fragmento para la generación de imágenes AI con facturación basada en uso! Esto es lo que lograste:Usage Meter
Se creó el “Image Generation Meter” que rastrea cada evento de generación de imagen
Billing Product
Se configuró un precio de $0.05 por imagen con 10 imágenes gratuitas mensuales
AI Application
Se creó una aplicación funcional en TypeScript que genera imágenes con DALL-E de OpenAI
Automated Billing
Se integró el seguimiento de eventos en tiempo real que factura automáticamente a los clientes