> ## 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.
# Cobrança Baseada em Uso
> Cobre os clientes com base no que eles realmente usam com medição flexível e cobrança automatizada.
A cobrança baseada em uso permite que você cobre os clientes pelo que eles realmente utilizam—chamadas de API, armazenamento, tokens de IA ou qualquer métrica que você definir. Os clientes pagam pelo consumo, não por taxas fixas.
**Perfeito para**: APIs, serviços de IA, plataformas de infraestrutura e qualquer produto cujo valor escala com o uso.
## Como Funciona
Seu aplicativo envia eventos quando ações faturáveis ocorrem.
```javascript theme={null}
{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
```
Os medidores agregam eventos em quantidades faturáveis usando agregação Count, Sum, Max ou Last.
Defina o preço por unidade e limites gratuitos. Os clientes são cobrados automaticamente a cada ciclo.
## Conceitos Principais
### Eventos
Os eventos representam ações de uso no seu aplicativo. Cada evento inclui:
* **Nome do Evento**: Tipo de uso (por exemplo, `api.call`)
* **ID do Cliente**: Quem o utilizou
* **Metadados**: Propriedades adicionais para agregação
### Medidores
Os medidores agregam eventos em quantidades cobradas:
* **Contagem**: Total de eventos (chamadas de API)
* **Soma**: Adicionar valores (total de bytes)
* **Máximo**: Maior valor (usuários de pico)
* **Último**: Valor mais recente
### Produtos com Preços Baseados em Uso
Defina preços por unidade e limites gratuitos opcionais:
**Exemplo**: 2.500 chamadas - 1.000 gratuitas = 1.500 × $0.02 = $30.00
### Dedução Baseada em Créditos
Em vez de cobrar por unidade em dólares, você pode configurar medidores para deduzirem do [saldo de créditos](/features/credit-based-billing) do cliente. Os créditos são renovados a cada ciclo de cobrança e são aplicados antes de quaisquer cobranças por excedentes.
## Início Rápido
No seu painel: **Meters** → **Create Meter**
1. Defina o nome do evento (por exemplo, `api.call`)
2. Escolha a agregação (Count, Sum, Max, Last)
3. Adicione filtros opcionais
Vincule o medidor a um produto com precificação:
1. Selecione **Usage-Based Billing**
2. Escolha seu medidor
3. Defina o preço por unidade e o limite gratuito
```javascript theme={null}
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: "unique_event_id",
customer_id: "cus_abc123",
event_name: "api.call",
metadata: { endpoint: "/v1/users" }
}]
})
});
```
Verifique o painel do seu medidor para ver os eventos e a agregação de uso. Os clientes são cobrados automaticamente a cada ciclo.
## Casos de Uso
Acompanhe chamadas de API, horas de computação, largura de banda e armazenamento. Exemplo: \$0,001 por chamada após 10.000 gratuitas.
Acompanhe tokens, gerações, tempo de processamento. Exemplo: \$0,04 por imagem padrão, \$0,08 por HD.
Cobre por dados processados, consultas executadas, registros analisados. Exemplo: \$5 por GB após 10 GB gratuitos.
Conte mensagens, minutos, dados transferidos. Exemplo: \$0,01 por SMS enviado.
## Próximos Passos
Aprenda como estruturar e enviar eventos de uso do seu aplicativo.
Domine a configuração de medidores, tipos de agregação e filtragem de eventos.
Crie um gerador de imagens com IA completo com faturamento baseado em uso do zero.
Guia abrangente para implementar faturamento baseado em uso no seu aplicativo.