Neste tutorial, você construirá o PixelGen AI - um serviço de geração de imagens AI de exemplo que demonstra cobrança baseada em uso. Vamos criar tudo do zero: o medidor de cobrança, a configuração do produto e o código de aplicação de exemplo que gera imagens e rastreia o uso em tempo real.Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
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 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
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