- Gera imagens com o modelo
gpt-image-2.5-flareda 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,
mediumehigh.
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
mediumehigh, pelo mesmo preço
- 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.
Open the Meters Section
- Faça login no dashboard do Dodo Payments.
- Acesse Products → Meters na barra lateral.
- Clique em Create Meter.
Enter the Meter Details
Image Generation MeterDescrição: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generatedConfigure How Images Are Counted
imagesAdd Quality Filtering

- Ative Ativar filtragem de eventos.
- Defina a lógica de correspondência como OU, para que um evento seja contabilizado quando qualquer condição corresponder.
- Adicione a primeira condição:
- Chave:
quality - Operador:
equals - Valor:
medium
- Chave:
- Clique em Adicionar condição e adicione a segunda:
- Chave:
quality - Operador:
equals - Valor:
high
- Chave:
Create Your Meter
- Verifique se todas as configurações correspondem aos valores acima. Não é possível editar um medidor depois de criá-lo.
- Clique em Create Meter.
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.Navigate to Products
- No dashboard do Dodo Payments, clique em Products na barra lateral.
- Clique em Add Product.
- Em Pricing Type, selecione Usage Based Billing.
Enter Product Details
PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: carregue uma imagem clara e relevante.Connect Your Meter

0, para que os clientes paguem apenas pelo uso, sem taxa fixa.Em seguida, vincule o medidor criado:- Role até a seção Associated Meters.
- Clique em Add meters.
- Selecione “Image Generation Meter” no menu suspenso.
- Confirme se o medidor aparece na configuração do produto.
Set Your Pricing

0.05, ou seja, $0.05 por imagem.Free Threshold: 10. Cada cliente recebe 10 imagens gratuitas por mês.Save Your Product
- Revise as configurações:
- Name: PixelGen AI - Image Generation
- Meter: Image Generation Meter
- Price: $0.05 por imagem
- Free tier: 10 imagens
- Clique em Save Changes.
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.Get Your Payment Link
- No dashboard do Dodo Payments, acesse Products.
- Encontre o produto “PixelGen AI - Image Generation”.
- Clique em Share ao lado do produto.
- Copie o link de pagamento.
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1.Complete a Test Purchase
- Abra o link de pagamento em uma nova aba do navegador.
- Insira os dados de pagamento de teste e conclua a compra.
Find Your Customer ID
- Volte ao dashboard do Dodo Payments.
- Acesse Sales → Customers na barra lateral.
- Encontre o cliente criado usando o endereço de e-mail de teste.
- Copie o ID do cliente. Ele tem esta aparência:
cus_abc123def456.
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.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.Set Up Your Project
Install Dependencies
Create the Main Application
index.ts e cole nele o código da aplicação abaixo..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.Set Up Your Environment
- Crie um arquivo
.envno diretóriopixelgen-ai. - Adicione suas chaves de API:
- Instale as dependências e execute a aplicação:
Generate Your First Test Image
sendUsageEvent foram omitidas:Generate a Few More Images
npm start uma vez por imagem, usando estes prompts:- “A sunset over mountains with purple clouds”
- “A steampunk coffee machine in a Victorian kitchen”
- “A friendly dragon reading a book in a library”
Check Your Dodo Payments Dashboard
- Abra o dashboard do Dodo Payments.
- Acesse Products → Meters e abra o Image Generation Meter.
- Selecione a aba Events.
- Encontre seus eventos de geração de imagem na lista.
- Nome do evento:
image.generated - ID do cliente: o ID do seu cliente de teste
Verify Billing Calculations

- No medidor, selecione a aba Customers.
- Encontre seu cliente de teste.
- Verifique a coluna Consumed Units.
Test the Billing Threshold
- Gere mais 8 imagens, totalizando 12.
- Abra novamente a aba Customers do medidor.
- Verifique os valores:
- Consumed Units: 12
- Chargeable Units: 2 (12 − 10 gratuitas)
- Total Price: $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 ao do medidor. Há distinção entre maiúsculas e minúsculas.
- Verifique se o ID do cliente existe no Dodo Payments.
- Teste a chave de API com uma chamada de API simples.
- Verifique a conectividade de rede e as configurações do firewall.