En este tutorial, construirás PixelGen AI - un servicio de generación de imágenes AI de ejemplo que demuestra la facturación basada en uso. Crearemos todo desde cero: el medidor de facturación, la configuración del producto y el código de aplicación de ejemplo que genera imágenes y rastrea el uso en tiempo real.Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
- 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)
- 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
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
imagesAdd 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
PixelGen AI - Image GenerationDescription: Copia esto → AI-powered image generation service with pay-per-use billingImagen del Producto: Sube una imagen clara y relevante.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
Set your pricing

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
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.
Find your customer ID
- Vuelve a tu panel de Dodo Payments
- Navega a Ventas → Clientes en la barra lateral
- Encuentra el cliente que acabas de crear (con el correo de prueba)
- Copia el ID del cliente - se verá así
cus_abc123def456
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.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
- 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
Generate a few more images
- “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
- 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
Verify billing calculations

- En tu medidor, ve a la pestaña Clientes
- Encuentra tu cliente de prueba
- Verifica la columna “Unidades Consumidas”
Test the billing threshold
- 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
Solución de Problemas
Problemas comunes 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 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