Este tutorial fornece código de implementação de exemplo para uma aplicação baseada em terminal. Você pode modificar este código para 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ê tem:
- 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.
1
Abra a seção de Medidores
- Faça login no seu painel do Dodo Payments
- Clique em Medidores na barra lateral esquerda
- Clique no botão Criar Medidor
2
Preencha as informações básicas do medidor
Agora vamos inserir os detalhes específicos para nosso serviço PixelGen AI:Nome do Medidor: Copie e cole exatamente →
Image Generation MeterDescrição: Copie isso → Tracks each AI image generation request made by customers using our DALL-E powered serviceNome do Evento: Isso é crucial - copie exatamente → image.generated3
Configure como contamos as imagens
Configure a agregação (como o medidor conta nossos eventos):Tipo de Agregação: Selecione Contar no menu suspensoUnidade de Medida: Digite →
imagesEstamos usando “Contar” porque queremos cobrar por imagem gerada, não por tamanho ou tempo de geração. Cada imagem bem-sucedida = 1 unidade cobrada.
4
Adicione filtragem de qualidade

- Ativar Filtragem de Eventos: Ative isso ON
- Lógica de Filtragem: Selecione OU (isso significa “contar se QUALQUER uma dessas condições for verdadeira”)
- Adicione a primeira condição:
- Chave da Propriedade:
quality - Comparador:
equals - Valor:
standard
- Chave da Propriedade:
- Clique em “Adicionar Condição” para a segunda:
- Chave da Propriedade:
quality - Comparador:
equals - Valor:
hd
- Chave da Propriedade:
5
Crie seu medidor
- Verifique se todas as suas configurações correspondem aos valores acima
- Clique em Criar Medidor
Medidor criado! Seu “Medidor de Geração de Imagens” agora está pronto para começar a contar gerações de imagens. Em seguida, vamos conectá-lo a um produto de cobrança.
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.1
Navegue até Produtos
- No seu painel do Dodo Payments, clique em Produtos na barra lateral esquerda
- Clique em Criar Produto
- Selecione Baseado em Uso como o tipo de produto
2
Insira os detalhes do produto
Preencha esses valores exatos para nosso serviço PixelGen AI:Nome do Produto: Copie isso →
PixelGen AI - Image GenerationDescrição: Copie isso → AI-powered image generation service with pay-per-use billingImagem do Produto: Faça upload de uma imagem clara e relevante.Essas aparecerão nas faturas dos clientes, então faça-as claras e profissionais.
3
Conecte seu medidor

0 para garantir que os clientes sejam cobrados apenas com base em seu 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.
4
Defina seu preço
Aqui é onde definimos nosso modelo de negócios:
Preço Por Unidade: Insira →

0.05 (isso é $0,05 por imagem)Limite Gratuito: Insira → 10 (os clientes recebem 10 imagens gratuitas por mês)5
Salve seu produto
- Revise todas as suas configurações:
- Nome: PixelGen AI - Geração de Imagens
- Medidor: Medidor de Geração de Imagens
- Preço: $0,05 por imagem
- Camada gratuita: 10 imagens
- Clique em Salvar Alterações
Produto criado! Sua cobrança agora está configurada. Os clientes serão automaticamente cobrados com base em seu uso de 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.1
Obtenha seu link de pagamento
- No seu painel do Dodo Payments, vá para Produtos
- Encontre seu produto “PixelGen AI - Geração de Imagens”
- Clique no botão Compartilhar ao lado do seu produto
- Copie o link de pagamento que aparece
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=12
Complete uma compra de teste
- Abra o link de pagamento em uma nova aba do navegador
- Insira os detalhes de pagamento de teste e complete a compra.
Após o pagamento bem-sucedido, você terá um ID de cliente que usaremos em nosso código de aplicação.
3
Encontre seu ID de cliente
- Volte ao seu painel do Dodo Payments
- Navegue até Clientes na barra lateral esquerda
- Encontre o cliente que você acabou de criar (com o e-mail de teste)
- Copie o ID do cliente - ele terá a seguinte aparência:
cus_abc123def456
Salve este ID de cliente - vamos codificá-lo em nosso código de aplicação 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.1
Configure seu projeto
Crie um novo diretório e inicialize o projeto:
2
Instale as dependências
Instale os pacotes que precisamos:
3
Crie a aplicação principal
Crie um arquivo chamado
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.1
Configure seu ambiente
Primeiro, certifique-se de que você tem tudo configurado:
- Crie um arquivo
.envem seu diretóriopixelgen-ai - Adicione suas chaves de API reais:
- Instale as dependências e execute o app:
2
Gere sua primeira imagem de teste
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ê ver “Evento de uso enviado com sucesso”, sua integração de cobrança está funcionando!
3
Gere mais algumas imagens
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”
4
Verifique seu painel do Dodo Payments
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 dos eventos:
image.generated - ID do cliente: Seu ID de cliente de teste
Você deve ver um evento para cada imagem que você gerou!
5
Verifique os cálculos de cobrança
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”
6
Teste o limite de cobrança
Vamos exceder a camada gratuita 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 cobrados automaticamente com base em seu uso real de geração de imagens.
Solução de Problemas
Problemas comuns e suas soluções:Eventos não aparecendo no painel
Eventos não aparecendo no painel
Causas possíveis:
- O nome do evento não corresponde exatamente à configuração do medidor
- O ID do cliente não existe em sua conta
- A chave da API é inválida ou expirou
- Problemas de conectividade de rede
- Verifique se o nome do evento corresponde exatamente à configuração do medidor (sensível a maiúsculas e minúsculas)
- Verifique se o ID do cliente existe no Dodo Payments
- Teste a chave da API com uma chamada de API simples
- Verifique 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:Medidor de Uso
Criado “Medidor de Geração de Imagens” que rastreia cada evento de geração de imagem
Produto de Cobrança
Configurado preço de $0,05 por imagem com 10 imagens gratuitas por mês
Aplicação AI
Construída uma aplicação TypeScript funcional que gera imagens usando a DALL-E da OpenAI
Cobrança Automatizada
Integrada rastreamento de eventos em tempo real que cobra automaticamente os clientes