Skip to main content
Para que seu agente de programação escreva a integração, instale o Dodo Agent Plugin. Ele adiciona as skills e os servidores MCP do Dodo Payments ao Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode.
Você criará o PixelGen AI, um serviço de geração de imagens AI de exemplo que cobra dos clientes por imagem com cobrança baseada em uso. Você criará o medidor de cobrança, o produto e o código de exemplo da aplicação que gera imagens e informa cada uma ao Dodo Payments à medida que isso acontece.
Este tutorial fornece código de exemplo para uma aplicação de terminal. Você pode adaptar o código ao seu framework, como React, Vue ou Angular, e à forma como sua aplicação coleta a entrada do usuário.
Ao terminar, você terá um serviço de exemplo funcional que:
  • Gera imagens com o modelo gpt-image-2.5-flare da OpenAI.
  • Rastreia cada geração de imagem para fins de cobrança.
  • Cobra dos clientes pelas imagens que eles geram.
  • Lida com dois níveis de qualidade, medium e high.

O que estamos criando

O PixelGen AI funciona assim:
  • Serviço: geração de imagens com a Image API da OpenAI
  • Modelo de preços: pagamento por imagem ($0.05 por imagem)
  • Nível gratuito: 10 imagens gratuitas por cliente por mês
  • Opções de qualidade: imagens de qualidade medium e high, pelo mesmo preço
Antes de começar, você precisa de:
  • Uma conta da Dodo Payments.
  • Acesso à OpenAI API. A OpenAI pode exigir a verificação da organização da API antes que você use os modelos GPT Image.
  • Node.js 22 ou posterior, além de conhecimento prático de TypeScript e Node.js.

Etapa 1: crie seu medidor de uso

Crie um medidor no dashboard do Dodo Payments que rastreie cada imagem gerada pelo serviço. O medidor conta os eventos faturáveis.
Formulário Create Meter no dashboard do Dodo Payments
O que você está criando: um medidor chamado “Image Generation Meter” que conta cada geração de imagem.
1

Open the Meters Section

  1. Faça login no dashboard do Dodo Payments.
  2. Acesse Products → Meters na barra lateral.
  3. Clique em Create Meter.
O formulário do medidor é aberto.
2

Enter the Meter Details

Insira os detalhes do PixelGen AI:Meter Name: Image Generation MeterDescrição: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generated
O nome do evento image.generated deve corresponder ao nome do evento enviado pelo código da aplicação. Os nomes dos eventos diferenciam maiúsculas de minúsculas.
3

Configure How Images Are Counted

Defina a agregação, que controla como o medidor combina os eventos:Aggregation Type: CountMeasurement Unit: images
Count cobra por imagem gerada, não por tamanho ou tempo de geração. Cada imagem bem-sucedida é uma unidade faturável.
4

Add Quality Filtering

Filtragem de eventos no formulário do medidor com duas condições de qualidade unidas por OR
Conte apenas imagens reais, não execuções de teste ou eventos malformados:
  1. Ative Ativar filtragem de eventos.
  2. Defina a lógica de correspondência como OU, para que um evento seja contabilizado quando qualquer condição corresponder.
  3. Adicione a primeira condição:
    • Chave: quality
    • Operador: equals
    • Valor: medium
  4. Clique em Adicionar condição e adicione a segunda:
    • Chave: quality
    • Operador: equals
    • Valor: high
Com esse filtro, o medidor contabiliza apenas eventos cuja qualidade seja medium ou high e ignora eventos de teste ou malformados.
5

Create Your Meter

  1. Verifique se todas as configurações correspondem aos valores acima. Não é possível editar um medidor depois de criá-lo.
  2. Clique em Create Meter.
Medidor criado. O “Image Generation Meter” está pronto para contar gerações de imagens. Em seguida, conecte-o a um produto de cobrança.

Etapa 2: crie seu produto de cobrança

Crie um produto que defina o preço: $0.05 por imagem, com 10 imagens gratuitas. O produto conecta o medidor à cobrança.
O que você está criando: um produto chamado “PixelGen AI - Image Generation” que cobra $0.05 por imagem após as primeiras 10 imagens gratuitas de cada mês.
1

Navigate to Products

  1. No dashboard do Dodo Payments, clique em Products na barra lateral.
  2. Clique em Add Product.
  3. Em Pricing Type, selecione Usage Based Billing.
Com esse tipo de preço, o Dodo Payments cobra com base no uso do medidor, em vez de um preço fixo de assinatura.
2

Enter Product Details

Insira estes valores:Product Name: PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: carregue uma imagem clara e relevante.
O nome e a descrição aparecem nas faturas dos clientes.
3

Connect Your Meter

Preço Usage Based Billing no formulário do produto com a seção Associated Meters
Verifique se o tipo de preço do produto é Usage Based Billing.Defina o Price como 0, para que os clientes paguem apenas pelo uso, sem taxa fixa.Em seguida, vincule o medidor criado:
  1. Role até a seção Associated Meters.
  2. Clique em Add meters.
  3. Selecione “Image Generation Meter” no menu suspenso.
  4. Confirme se o medidor aparece na configuração do produto.
O medidor está conectado ao produto.
4

Set Your Pricing

Defina o preço por imagem e o nível gratuito:
Preço do medidor com campos de preço por unidade e limite gratuito
Price per unit: 0.05, ou seja, $0.05 por imagem.Free Threshold: 10. Cada cliente recebe 10 imagens gratuitas por mês.
Como a cobrança funciona: um cliente que gerar 25 imagens em um mês pagará por 15 imagens (25 − 10 gratuitas). 15 × $0.05 = $0.75.
5

Save Your Product

  1. Revise as configurações:
    • Name: PixelGen AI - Image Generation
    • Meter: Image Generation Meter
    • Price: $0.05 por imagem
    • Free tier: 10 imagens
  2. Clique em Save Changes.
Produto criado. A cobrança está configurada, e os clientes são cobrados pelas imagens que geram.

Etapa 3: faça uma compra de teste

Compre o produto uma vez no modo de teste. A compra cria o cliente para o qual a aplicação envia os eventos de uso.
1

Get Your Payment Link

  1. No dashboard do Dodo Payments, acesse Products.
  2. Encontre o produto “PixelGen AI - Image Generation”.
  3. Clique em Share ao lado do produto.
  4. Copie o link de pagamento.
O link de pagamento tem esta aparência: https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1.
2

Complete a Test Purchase

  1. Abra o link de pagamento em uma nova aba do navegador.
  2. Insira os dados de pagamento de teste e conclua a compra.
Depois que o pagamento for aprovado, a compra criará um cliente. O código da aplicação usará o ID desse cliente.
3

Find Your Customer ID

  1. Volte ao dashboard do Dodo Payments.
  2. Acesse Sales → Customers na barra lateral.
  3. Encontre o cliente criado usando o endereço de e-mail de teste.
  4. Copie o ID do cliente. Ele tem esta aparência: cus_abc123def456.
Salve esse ID de cliente. A aplicação de exemplo o define no código, para que cada evento seja registrado para esse cliente.

Etapa 4: crie a aplicação de exemplo

Com a cobrança configurada e um cliente de teste criado, crie a aplicação de exemplo PixelGen AI. Ela gera uma imagem e a informa ao Dodo Payments para cobrança.
O exemplo chama o modelo gpt-image-2.5-flare da OpenAI por meio da Image API. A Image API retorna dados de imagem codificados em base64, então o exemplo salva cada imagem como um arquivo PNG. A parte da Dodo Payments (o medidor, o produto e o evento de uso image.generated) não depende do modelo.
1

Set Up Your Project

Crie um diretório e inicialize o projeto:
2

Install Dependencies

Instale os pacotes:
3

Create the Main Application

Crie um arquivo chamado index.ts e cole nele o código da aplicação abaixo.
A aplicação PixelGen AI completa com cobrança, além do .env e do package.json correspondentes:

Etapa 5: teste sua aplicação de exemplo

Teste o PixelGen AI de ponta a ponta e acompanhe o uso chegando ao Dodo Payments.
O que você está testando: você gerará algumas imagens, confirmará que os eventos chegam ao Dodo Payments e verificará o cálculo da cobrança.
1

Set Up Your Environment

  1. Crie um arquivo .env no diretório pixelgen-ai.
  2. Adicione suas chaves de API:
  1. Instale as dependências e execute a aplicação:
Use chaves de API reais e substitua o ID de cliente codificado em index.ts pelo ID de cliente da Etapa 3.
2

Generate Your First Test Image

Quando a aplicação iniciar, ela exibirá:
Insira este prompt: “A cute robot painting a landscape”A saída será semelhante a esta. As linhas de depuração da solicitação exibidas por sendUsageEvent foram omitidas:
Se a saída incluir “Usage event sent successfully”, a integração de cobrança está funcionando.
3

Generate a Few More Images

Gere mais duas ou três imagens para testar vários eventos. Execute npm start uma vez por imagem, usando estes 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”
A cada vez, verifique a mensagem “Usage event sent successfully”.
4

Check Your Dodo Payments Dashboard

Confirme se o Dodo Payments recebeu os eventos:
  1. Abra o dashboard do Dodo Payments.
  2. Acesse Products → Meters e abra o Image Generation Meter.
  3. Selecione a aba Events.
  4. Encontre seus eventos de geração de imagem na lista.
O que procurar:
  • Nome do evento: image.generated
  • ID do cliente: o ID do seu cliente de teste
A lista tem um evento para cada imagem gerada.
5

Verify Billing Calculations

Verifique a contagem de uso:
Aba Customers do medidor mostrando unidades consumidas por cliente
  1. No medidor, selecione a aba Customers.
  2. Encontre seu cliente de teste.
  3. Verifique a coluna Consumed Units.
6

Test the Billing Threshold

Ultrapasse o nível gratuito para ver a cobrança:
  1. Gere mais 8 imagens, totalizando 12.
  2. Abra novamente a aba Customers do medidor.
  3. Verifique os valores:
    • Consumed Units: 12
    • Chargeable Units: 2 (12 − 10 gratuitas)
    • Total Price: $0.10
A cobrança baseada em uso funciona. Os clientes são cobrados pelas imagens que geram.

Solução de problemas

Problemas comuns e suas soluções:
Possíveis causas:
  • O nome do evento não corresponde exatamente à configuração do medidor
  • O ID do cliente não existe na sua conta
  • A chave de API é inválida ou expirou
  • Problemas de conectividade de rede
Soluções:
  1. Verifique se o nome do evento corresponde exatamente ao do medidor. Há distinção entre maiúsculas e minúsculas.
  2. Verifique se o ID do cliente existe no Dodo Payments.
  3. Teste a chave de API com uma chamada de API simples.
  4. Verifique a conectividade de rede e as configurações do firewall.

Parabéns! Você criou o PixelGen AI

Você criou um gerador de imagens AI de exemplo com cobrança baseada em uso:

Usage Meter

Um “Image Generation Meter” que conta cada evento de geração de imagem.

Billing Product

Preço de $0.05 por imagem, com 10 imagens gratuitas por mês.

AI Application

Uma aplicação TypeScript que gera imagens com a OpenAI image API.

Automated Billing

Rastreamento de eventos que informa cada imagem à medida que é gerada, para que os clientes sejam cobrados pelo uso.
Última modificação em 26 de setembro de 2026