Skip to main content
Para que tu agente de programación escriba la integración, instala el Dodo Agent Plugin. Añade las habilidades de Dodo Payments y los servidores MCP a Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro y OpenCode.
Crearás PixelGen AI, un servicio de ejemplo de generación de imágenes de IA que factura a los clientes por imagen mediante facturación basada en el uso. Crearás el medidor de facturación, el producto y el código de una aplicación de ejemplo que genera imágenes y notifica cada una a Dodo Payments a medida que se genera.
Este tutorial proporciona código de ejemplo para una aplicación de terminal. Puedes adaptar el código a tu framework, como React, Vue o Angular, y a la forma en que tu aplicación recopila las entradas del usuario.
Al terminar, tendrás un servicio de ejemplo funcional que:
  • Genera imágenes con el modelo gpt-image-2.5-flare de OpenAI.
  • Registra cada generación de imagen para la facturación.
  • Cobra a los clientes por las imágenes que generan.
  • Gestiona dos niveles de calidad, medium y high.

Lo que vamos a crear

PixelGen AI funciona así:
  • Servicio: Generación de imágenes con la Image API de OpenAI
  • Modelo de precios: Pago por imagen ($0.05 por imagen)
  • Nivel gratuito: 10 imágenes gratis por cliente al mes
  • Opciones de calidad: Imágenes de calidad medium y high, al mismo precio
Antes de comenzar, necesitas:
  • Una cuenta de Dodo Payments.
  • Acceso a la API de OpenAI. OpenAI puede requerir la verificación de la organización de la API antes de que uses los modelos GPT Image.
  • Node.js 22 o posterior, y conocimientos prácticos de TypeScript y Node.js.

Paso 1: Crea tu medidor de uso

Crea un medidor en el dashboard de Dodo Payments que registre cada imagen que genere el servicio. El medidor cuenta los eventos facturables.
Create Meter form in the Dodo Payments dashboard
Lo que estás creando: un medidor llamado “Image Generation Meter” que cuenta cada generación de imagen.
1

Open the Meters Section

  1. Inicia sesión en el dashboard de Dodo Payments.
  2. Ve a Products → Meters en la barra lateral.
  3. Haz clic en Create Meter.
Se abre el formulario del medidor.
2

Enter the Meter Details

Introduce los detalles de PixelGen AI:Meter Name: Image Generation MeterDescripción: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generated
El nombre del evento image.generated debe coincidir con el nombre del evento que envía el código de la aplicación. Los nombres de los eventos distinguen entre mayúsculas y minúsculas.
3

Configure How Images Are Counted

Configura la agregación, que controla cómo combina el medidor los eventos:Aggregation Type: CountMeasurement Unit: images
Count factura por imagen generada, no por tamaño ni por tiempo de generación. Cada imagen generada correctamente es una unidad facturable.
4

Add Quality Filtering

Event filtering on the meter form with two quality conditions joined by OR
Cuenta solo las imágenes reales, no las ejecuciones de prueba ni los eventos con formato incorrecto:
  1. Activa Enable Event Filtering.
  2. Establece la lógica de coincidencia en OR, para que un evento se contabilice cuando coincida cualquier condición.
  3. Añade la primera condición:
    • Clave: quality
    • Operador: equals
    • Valor: medium
  4. Haz clic en Add condition y añade la segunda:
    • Clave: quality
    • Operador: equals
    • Valor: high
Con este filtro, el medidor cuenta únicamente los eventos cuya calidad sea medium o high, e ignora los eventos de prueba o con un formato incorrecto.
5

Create Your Meter

  1. Comprueba que cada configuración coincida con los valores anteriores. No puedes editar un medidor después de crearlo.
  2. Haz clic en Create Meter.
Medidor creado. El “Image Generation Meter” está listo para contar las generaciones de imágenes. A continuación, conéctalo a un producto de facturación.

Paso 2: Crea tu producto de facturación

Crea un producto que defina el precio: $0.05 por imagen, con 10 imágenes gratuitas. El producto conecta el medidor con la facturación.
Lo que estás creando: un producto llamado “PixelGen AI - Image Generation” que cobra $0.05 por imagen después de las primeras 10 imágenes gratuitas de cada mes.
1

Navigate to Products

  1. En el dashboard de Dodo Payments, haz clic en Products en la barra lateral.
  2. Haz clic en Add Product.
  3. En Pricing Type, selecciona Usage Based Billing.
Con este tipo de precios, Dodo Payments factura según el uso del medidor en lugar de aplicar un precio de suscripción fijo.
2

Enter Product Details

Introduce estos valores:Product Name: PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: Sube una imagen clara y relevante.
El nombre y la descripción aparecen en las facturas de los clientes.
3

Connect Your Meter

Usage Based Billing pricing on the product form with the Associated Meters section
Comprueba que el tipo de precios del producto sea Usage Based Billing.Establece el Price en 0, para que los clientes paguen solo por el uso, sin una tarifa base.A continuación, vincula el medidor que creaste:
  1. Desplázate hasta la sección Associated Meters.
  2. Haz clic en Add meters.
  3. Selecciona “Image Generation Meter” en el menú desplegable.
  4. Confirma que el medidor aparezca en la configuración del producto.
El medidor está conectado al producto.
4

Set Your Pricing

Define el precio por imagen y el nivel gratuito:
Meter pricing with price per unit and free threshold fields
Price per unit: 0.05, es decir, $0.05 por imagen.Free Threshold: 10. Cada cliente obtiene 10 imágenes gratuitas al mes.
Cómo funciona la facturación: un cliente que genere 25 imágenes en un mes paga por 15 imágenes (25 − 10 gratuitas). 15 × $0.05 = $0.75.
5

Save Your Product

  1. Revisa la configuración:
    • Name: PixelGen AI - Image Generation
    • Meter: Image Generation Meter
    • Price: $0.05 por imagen
    • Free tier: 10 imágenes
  2. Haz clic en Save Changes.
Producto creado. La facturación está configurada y se cobra a los clientes por las imágenes que generan.

Paso 3: Realiza una compra de prueba

Compra el producto una vez en modo de prueba. La compra crea el cliente para el que la aplicación enviará los eventos de uso.
1

Get Your Payment Link

  1. En el dashboard de Dodo Payments, ve a Products.
  2. Busca el producto “PixelGen AI - Image Generation”.
  3. Haz clic en Share junto al producto.
  4. Copia el enlace de pago.
El enlace de pago tiene un formato similar a https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1.
2

Complete a Test Purchase

  1. Abre el enlace de pago en una pestaña nueva del navegador.
  2. Introduce los datos de pago de prueba y completa la compra.
Después de que el pago se complete correctamente, la compra crea un cliente. El código de la aplicación utiliza el ID de ese cliente.
3

Find Your Customer ID

  1. Regresa al dashboard de Dodo Payments.
  2. Ve a Sales → Customers en la barra lateral.
  3. Busca el cliente que creaste mediante su dirección de correo electrónico de prueba.
  4. Copia el ID del cliente. Tiene un formato similar a cus_abc123def456.
Guarda este ID de cliente. La aplicación de ejemplo lo establece en el código, por lo que cada evento se registra para este cliente.

Paso 4: Crea la aplicación de ejemplo

Con la facturación configurada y un cliente de prueba creado, crea la aplicación PixelGen AI de ejemplo. Genera una imagen y la notifica a Dodo Payments para la facturación.
El ejemplo llama al modelo gpt-image-2.5-flare de OpenAI a través de la Image API. La Image API devuelve datos de imagen codificados en base64, por lo que el ejemplo guarda cada imagen como un archivo PNG. La parte de Dodo Payments (el medidor, el producto y el evento de uso image.generated) no depende del modelo.
1

Set Up Your Project

Crea un directorio e inicializa el proyecto:
2

Install Dependencies

Instala los paquetes:
3

Create the Main Application

Crea un archivo llamado index.ts y pega en él el código de la aplicación que aparece a continuación.
La aplicación completa de PixelGen AI con facturación, junto con el .env y el package.json correspondientes:

Paso 5: Prueba tu aplicación de ejemplo

Prueba PixelGen AI de principio a fin y observa cómo llega el uso a Dodo Payments.
Lo que estás probando: generarás algunas imágenes, confirmarás que los eventos llegan a Dodo Payments y comprobarás el cálculo de la facturación.
1

Set Up Your Environment

  1. Crea un archivo .env en el directorio pixelgen-ai.
  2. Añade tus claves de API:
  1. Instala las dependencias y ejecuta la aplicación:
Usa claves de API reales y reemplaza el ID de cliente codificado directamente en index.ts por el ID de cliente del Paso 3.
2

Generate Your First Test Image

Cuando se inicia la aplicación, muestra:
Introduce este prompt: “A cute robot painting a landscape”El resultado tiene este aspecto. Se omiten las líneas de depuración de la solicitud que imprime sendUsageEvent:
Si el resultado incluye “Usage event sent successfully”, la integración de facturación funciona.
3

Generate a Few More Images

Genera dos o tres imágenes más para probar varios eventos. Ejecuta npm start una vez por imagen con estos prompts:
  1. “A sunset over mountains with purple clouds”
  2. “A steampunk coffee machine in a Victorian kitchen”
  3. “A friendly dragon reading a book in a library”
Cada vez, comprueba que aparezca el mensaje “Usage event sent successfully”.
4

Check Your Dodo Payments Dashboard

Confirma que Dodo Payments recibe los eventos:
  1. Abre el dashboard de Dodo Payments.
  2. Ve a Products → Meters y abre Image Generation Meter.
  3. Selecciona la pestaña Events.
  4. Busca tus eventos de generación de imágenes en la lista.
Qué debes buscar:
  • Nombre del evento: image.generated
  • ID del cliente: el ID de tu cliente de prueba
La lista contiene un evento por cada imagen que generaste.
5

Verify Billing Calculations

Comprueba el recuento de uso:
Customers tab of the meter showing consumed units per customer
  1. En el medidor, selecciona la pestaña Customers.
  2. Busca tu cliente de prueba.
  3. Comprueba la columna Consumed Units.
6

Test the Billing Threshold

Supera el nivel gratuito para ver la facturación:
  1. Genera 8 imágenes más, para un total de 12.
  2. Vuelve a abrir la pestaña Customers del medidor.
  3. Comprueba los valores:
    • Consumed Units: 12
    • Chargeable Units: 2 (12 − 10 gratuitas)
    • Total Price: $0.10
La facturación basada en el uso funciona. Se cobra a los clientes por las imágenes que generan.

Solución de problemas

Problemas comunes y sus soluciones:
Posibles causas:
  • El nombre del evento no coincide exactamente con la configuración del medidor
  • El ID del cliente no existe en tu cuenta
  • La clave de API no es válida o ha caducado
  • Problemas de conectividad de red
Soluciones:
  1. Comprueba que el nombre del evento coincida exactamente con el del medidor. Distingue entre mayúsculas y minúsculas.
  2. Comprueba que el ID del cliente exista en Dodo Payments.
  3. Prueba la clave de API con una llamada de API sencilla.
  4. Comprueba la conectividad de red y la configuración del firewall.

¡Enhorabuena! Has creado PixelGen AI

Has creado un generador de imágenes de IA de ejemplo con facturación basada en el uso:

Usage Meter

Un “Image Generation Meter” que cuenta cada evento de generación de imágenes.

Billing Product

Un precio de $0.05 por imagen, con 10 imágenes gratuitas al mes.

AI Application

Una aplicación de TypeScript que genera imágenes con la API de imágenes de OpenAI.

Automated Billing

Seguimiento de eventos que notifica cada imagen a medida que se genera, para que los clientes reciban cargos por el uso.
Última modificación el 26 de septiembre de 2026