Este tutorial proporciona código de implementación de ejemplo para una aplicación basada en terminal. Puedes modificar este código para tu marco específico (React, Vue, Angular, etc.) y personalizar el método de entrada del usuario de acuerdo a 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
- Familiaridad básica con 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.
Abre la sección de Medidores
- Inicia sesión en tu panel de Dodo Payments
- Haz clic en Medidores en la barra lateral izquierda
- Haz clic en el botón Crear Medidor
Completa la información básica del medidor
Ahora ingresaremos los detalles específicos para nuestro servicio PixelGen AI:Nombre del Medidor: Copia y pega esto exactamente →
Image Generation MeterDescripción: Copia esto → Tracks each AI image generation request made by customers using our DALL-E powered serviceNombre del Evento: Esto es crucial - copia exactamente → image.generatedConfigura cómo contamos las imágenes
Configura la agregación (cómo el medidor cuenta nuestros eventos):Tipo de Agregación: Selecciona Contar del menú desplegableUnidad de Medida: Escribe →
imagesEstamos usando “Contar” porque queremos facturar por cada imagen generada, no por tamaño o tiempo de generación. Cada imagen exitosa = 1 unidad facturable.
Agrega filtrado de calidad

- Habilitar Filtrado de Eventos: Activa esto EN
- Lógica de Filtrado: Selecciona O (esto significa “contar si CUALQUIERA de estas condiciones son verdaderas”)
- Agrega la primera condición:
- Clave de Propiedad:
quality - Comparador:
equals - Valor:
standard
- Clave de Propiedad:
- Haz clic en “Agregar Condición” para la segunda:
- Clave de Propiedad:
quality - Comparador:
equals - Valor:
hd
- Clave de Propiedad:
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.Navega a Productos
- En tu panel de Dodo Payments, haz clic en Productos en la barra lateral izquierda
- Haz clic en Crear Producto
- Selecciona Basado en Uso como el tipo de producto
Ingresa los detalles del producto
Completa estos valores exactos para nuestro servicio PixelGen AI:Nombre del Producto: Copia esto →
PixelGen AI - Image GenerationDescripción: Copia esto → AI-powered image generation service with pay-per-use billingImagen del Producto: Sube una imagen clara y relevante.Estas aparecerán en las facturas de los clientes, así que hazlas claras y profesionales.
Conecta tu medidor

0 para asegurar que los clientes solo sean cobrados según su uso, sin tarifa 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 ahora está conectado exitosamente a este producto.
Establece tu precio
Aquí es donde definimos nuestro modelo de negocio:
Precio Por Unidad: Ingresa →

0.05 (esto es $0.05 por imagen)Umbral Gratuito: Ingresa → 10 (los clientes obtienen 10 imágenes gratis por mes)Guarda tu producto
- Revisa todos tus ajustes:
- Nombre: PixelGen AI - Generación de Imágenes
- Medidor: Medidor de Generación de Imágenes
- Precio: $0.05 por imagen
- Nivel gratuito: 10 imágenes
- Haz clic en Guardar Cambios
¡Producto creado! Tu facturación ahora 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.Obtén tu enlace de pago
- En tu panel de Dodo Payments, ve a Productos
- Encuentra tu producto “PixelGen AI - Generación de Imágenes”
- Haz clic en el botón Compartir junto a tu producto
- Copia el enlace de pago que aparece
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1Completa una compra de prueba
- Abre el enlace de pago en una nueva pestaña del navegador
- Ingresa los detalles de pago de prueba y completa la compra.
Después del pago exitoso, tendrás un ID de cliente que utilizaremos en nuestro código de aplicación.
Encuentra tu ID de cliente
- Regresa a tu panel de Dodo Payments
- Navega a Clientes en la barra lateral izquierda
- Encuentra el cliente que acabas de crear (con el correo electrónico de prueba)
- Copia el ID del cliente - se verá como
cus_abc123def456
Guarda este ID de cliente - lo codificaremos en nuestro código de aplicación de ejemplo para asegurar 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.Configura tu entorno
Primero, asegúrate de que todo esté configurado:
- Crea un archivo
.enven tu directoriopixelgen-ai - Agrega tus claves API reales:
- Instala las dependencias y ejecuta la aplicación:
Genera tu primera imagen de prueba
Cuando la aplicación se inicie, verás:Prueba este prompt: “Un robot lindo pintando un paisaje”Deberías ver una salida como esta:
Si ves “Evento de uso enviado exitosamente”, ¡tu integración de facturación está funcionando!
Genera algunas imágenes más
Generemos de 2 a 3 imágenes más para probar múltiples eventos. Prueba 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”
Verifica tu panel de Dodo Payments
Ahora verifiquemos que los eventos están siendo recibidos:
- 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 que generaste!
Verifica los cálculos de facturación
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”
Prueba el umbral de facturación
Superemos el nivel gratuito 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 está funcionando perfectamente. Los clientes serán cobrados automáticamente según su uso real de generación de imágenes.
Solución de Problemas
Problemas comunes y sus soluciones:Eventos no aparecen en el panel
Eventos no aparecen en el panel
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 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 (sensible a mayúsculas y minúsculas)
- Verifica que el ID de cliente exista en Dodo Payments
- Prueba la clave API con una llamada API simple
- Verifica 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:Medidor de Uso
Creado “Medidor de Generación de Imágenes” que rastrea cada evento de generación de imágenes
Producto de Facturación
Configurado precios a $0.05 por imagen con 10 imágenes gratuitas por mes
Aplicación AI
Construida una aplicación funcional en TypeScript que genera imágenes utilizando DALL-E de OpenAI
Facturación Automatizada
Integrada el rastreo de eventos en tiempo real que factura automáticamente a los clientes