Este tutorial fornece código de implementação de exemplo para um aplicativo baseado em terminal. Você pode modificar esse código para o seu framework específico (React, Vue, Angular etc.) e personalizar o método de entrada do usuário de acordo com as necessidades da sua aplicação.
- Gera imagens usando a API DALL-E da OpenAI
- Rastreia cada geração de imagem para cobrança
- Cobra automaticamente os clientes com base no uso
- Lida com diferentes níveis de qualidade (padrão vs HD)
O Que Estamos Construindo
Vamos começar entendendo nosso serviço PixelGen AI:- Serviço: Geração de imagens AI usando a API DALL-E da OpenAI
- Modelo de Preço: Cobrança por imagem ($0,05 por imagem)
- Camada Gratuita: 10 imagens gratuitas por cliente por mês
- Opções de Qualidade: Imagens padrão e HD (mesmo preço para simplicidade)
Antes de começarmos, certifique-se de que você possui:
- Uma conta no Dodo Payments
- Acesso à API da OpenAI
- Familiaridade básica com TypeScript/Node.js
Passo 1: Crie Seu Medidor de Uso
Começaremos criando um medidor no seu painel do Dodo Payments que rastreará cada imagem que nosso serviço gera. Pense nisso como o “contador” que rastreia eventos cobrados.
Open the Meters section
- Faça login no seu painel do Dodo Payments
- Clique em Meters na barra lateral esquerda
- Clique no botão Create Meter
Fill in the basic meter information
Agora vamos inserir os detalhes específicos para o nosso serviço PixelGen AI:Meter Name: Copie e cole exatamente isto →
Image Generation MeterDescription: Copie isto → Tracks each AI image generation request made by customers using our DALL-E powered serviceEvent Name: Isto é crucial – copie exatamente → image.generatedConfigure how we count images
Configure a agregação (como o medidor conta nossos eventos):Tipo de Agregação: Selecione Contar no menu suspensoMeasurement Unit: Digite →
imagesEstamos usando “Count” porque queremos cobrar por imagem gerada, não por tamanho ou tempo de geração. Cada imagem bem-sucedida = 1 unidade faturável.
Add quality filtering

- Ative o Event Filtering: alterne para ON
- Lógica de Filtro: selecione OR (isso significa “contar se QUALQUER uma dessas condições for verdadeira”)
- Adicione a primeira condição:
- Property Key:
quality - Comparator:
equals - Value:
standard
- Property Key:
- Clique em “Add Condition” para a segunda:
- Property Key:
quality - Comparator:
equals - Value:
hd
- Property Key:
Passo 2: Crie Seu Produto de Cobrança
Agora precisamos criar um produto que defina nosso preço ($0,05 por imagem com 10 imagens gratuitas). Isso conecta nosso medidor à cobrança real.Navigate to Products
- No painel do Dodo Payments, clique em Products na barra lateral esquerda
- Clique em Create Product
- Selecione Usage-Based como tipo de produto
Enter product details
Preencha estes valores exatos para o nosso serviço PixelGen AI:Product Name: Copie isto →
PixelGen AI - Image GenerationDescription: Copie isto → AI-powered image generation service with pay-per-use billingImagem do Produto: Faça upload de uma imagem clara e relevante.Esses dados aparecerão nas faturas dos clientes, então mantenha-os claros e profissionais.
Connect your meter

0 para garantir que os clientes sejam cobrados apenas com base no uso, sem taxa base.Agora, vincule o medidor que você acabou de criar:- Role para baixo até a seção Medidor Associado
- Clique em Adicionar Medidores
- No menu suspenso, selecione “Medidor de Geração de Imagens” (o que você criou anteriormente)
- Confirme que ele aparece na configuração do seu produto
Seu medidor agora está conectado com sucesso a este produto.
Set your pricing
Aqui é onde definimos o nosso modelo de negócios:
Price Per Unit: Insira →

0.05 (isso é $0.05 por imagem)Free Threshold: Insira → 10 (os clientes recebem 10 imagens gratuitas por mês)Save your product
- Revise todas as suas configurações:
- Nome: PixelGen AI - Image Generation
- Medidor: Image Generation Meter
- Preço: $0.05 por imagem
- Camada gratuita: 10 imagens
- Clique em Save Changes
Produto criado! Sua cobrança agora está configurada. Os clientes serão automaticamente cobrados com base no uso da geração de imagens.
Passo 3: Faça uma Compra de Teste
Antes de começarmos a ingerir eventos de uso, precisamos fazer uma compra de teste.Get your payment link
- No painel do Dodo Payments, vá para Products
- Encontre seu produto “PixelGen AI - Image Generation”
- Clique no botão Share ao lado do seu produto
- Copie o link de pagamento que aparecer
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1Complete a test purchase
- Abra o link de pagamento em uma nova aba do navegador
- Insira dados de pagamento de teste e conclua a compra.
Após o pagamento bem-sucedido, você terá um ID de cliente que usaremos em nosso código de aplicação.
Find your customer ID
- Volte para o painel do Dodo Payments
- Navegue até Customers na barra lateral esquerda
- Encontre o cliente que você acabou de criar (com o e-mail de teste)
- Copie o ID do cliente – ele ficará parecido com
cus_abc123def456
Salve esse ID de cliente – nós o codificaremos diretamente no nosso código de exemplo para garantir que os eventos sejam rastreados corretamente.
Passo 4: Construa a Aplicação de Exemplo
Agora que temos nossa configuração de cobrança completa e um cliente de teste criado. Vamos construir a aplicação de exemplo PixelGen AI que gera imagens e rastreia automaticamente o uso para cobrança.
Aqui está a aplicação completa do PixelGen AI com cobrança integrada:
Passo 5: Teste Sua Aplicação de Exemplo
Hora de testar nosso serviço de exemplo PixelGen AI e ver a cobrança em ação! Vamos garantir que tudo funcione de ponta a ponta.Set up your environment
Primeiro, certifique-se de que tudo está configurado:
- Crie um arquivo
.envno diretóriopixelgen-ai - Adicione suas chaves de API reais:
- Instale as dependências e execute o app:
Generate your first test image
Quando o app iniciar, você verá:Tente este prompt: “Um robô fofo pintando uma paisagem”Você deve ver uma saída como esta:
Se você vir “Usage event sent successfully”, sua integração de cobrança está funcionando!
Generate a few more images
Vamos gerar mais 2-3 imagens para testar múltiplos eventos. Tente estes prompts:
- “Um pôr do sol sobre montanhas com nuvens roxas”
- “Uma máquina de café steampunk em uma cozinha vitoriana”
- “Um dragão amigável lendo um livro em uma biblioteca”
Check your Dodo Payments dashboard
Agora vamos verificar se os eventos estão sendo recebidos:
- Abra seu painel do Dodo Payments
- Vá para Cobrança por Uso → *Medidores → Medidor de Geração de Imagens
- Clique na aba Eventos
- Você deve ver seus eventos de geração de imagens listados
- Nomes de eventos:
image.generated - ID do cliente: o seu ID de cliente de teste
Você deve ver um evento para cada imagem que gerou!
Verify billing calculations
Vamos verificar se a contagem de uso está funcionando:

- No seu medidor, vá para a aba Clientes
- Encontre seu cliente de teste
- Verifique a coluna “Unidades Consumidas”
Test the billing threshold
Vamos exceder o limite gratuito para ver a cobrança em ação:
- Gere mais 8 imagens (para atingir 12 no total)
- Verifique seu painel do medidor novamente
- Você deve agora ver:
- Unidades consumidas: 12
- Unidades cobradas: 2 (12 - 10 gratuitas)
- Valor da cobrança: $0,10
Sucesso! Sua cobrança baseada em uso está funcionando perfeitamente. Os clientes serão automaticamente cobrados com base no uso real da geração de imagens.
Solução de Problemas
Problemas comuns e suas soluções:Events not appearing in dashboard
Events not appearing in dashboard
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
- Verifique se o nome do evento corresponde exatamente à configuração do medidor (diferencia maiúsculas de minúsculas)
- Cheque se o ID do cliente existe no Dodo Payments
- Teste a chave de API com uma chamada simples
- Confira a conectividade de rede e as configurações de firewall
Parabéns! Você Construiu o PixelGen AI
Você criou com sucesso um snippet para geração de imagens AI com cobrança baseada em uso! Aqui está o que você realizou:Usage Meter
Criado o “Image Generation Meter” que rastreia cada evento de geração de imagem
Billing Product
Configurado o preço de $0.05 por imagem com 10 imagens gratuitas por mês
AI Application
Construímos um app TypeScript funcional que gera imagens usando o DALL-E da OpenAI
Automated Billing
Integrado rastreamento de eventos em tempo real que cobra automaticamente os clientes