- 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)
- 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
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
imagesAdd 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:
Create your meter
- Verifique novamente se todas as suas configurações correspondem aos valores acima
- Clique em Create Meter
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
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.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
Set your pricing

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
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.
Find your customer ID
- Volte para o seu painel de controle do Dodo Payments
- Navegue até Vendas → Clientes na barra lateral
- Encontre o cliente que você acabou de criar (com o e-mail de teste)
- Copie o ID do cliente - ele parecerá com
cus_abc123def456
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.Set up your project
Install dependencies
Create the main application
index.ts e copie este código completo da aplicação: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
- 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
Generate a few more images
- “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
- 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
Verify billing calculations

- No seu medidor, vá para a aba Clientes
- Encontre seu cliente de teste
- Verifique a coluna “Unidades Consumidas”
Test the billing threshold
- 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
Solução de Problemas
Problemas comuns e suas soluções:Events not appearing in dashboard
Events not appearing in dashboard
- 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