Consumo de API
Acompanhe em tempo real o uso e custo das APIs de IA (OpenAI, Anthropic) usadas na classificação e extração de dados de e-mails. A tela de consumo é essencial para o gestor e administrador controlarem o orçamento de IA.
Visao Geral da Tela#
A tela de Consumo de API apresenta um dashboard completo com KPIs de custo, tabelas de uso mensal e diario, e ferramentas de filtro e exportacao.
Monitoramento
Resumo de Consumo
Todo periodo · cambio 5.4500 · markup 30,00% · imposto NF 18,00%
Custo OpenAI
$127.42
Total NF estimado
R$ 918,31
Impostos estimados
R$ 139,82
Chamadas / Tokens
1.247.830
342 chamadas
Consumo Mensal por Modelo
Meses que cruzam o periodo selecionado
| Mes | Provider | Modelo | Modo | Chamadas | Tokens | Custo USD | Total NF |
|---|---|---|---|---|---|---|---|
| Maio 2026 | openai | gpt-4o-mini | chat | 287 | 1.049.830 | $94.12 | R$ 679,16 |
| Maio 2026 | anthropic | claude-3-haiku | chat | 55 | 198.000 | $33.30 | R$ 239.15 |
| Abril 2026 | openai | gpt-4o-mini | chat | 891 | 3.210.000 | $288.90 | R$ 2.083,68 |
KPIs do Dashboard#
O topo do dashboard apresenta 4 cards com indicadores-chave:
Custo total em dolares (USD) cobrado pela API do provider (OpenAI, Anthropic) no periodo selecionado. Valor bruto antes de markup e impostos.
Estimativa do valor final da Nota Fiscal em reais (BRL). Inclui: custo convertido para reais + markup + imposto NF. Este e o valor que aparecera na nota de faturamento interno.
Valor do imposto (tax_gross_up_rate) em reais sobre o subtotal com markup. A aliquota padrao e configurada pelo administrador e reflete os tributos sobre servicos (ISS, PIS, COFINS etc.).
Total de chamadas API e tokens consumidos no periodo. Tokens sao a unidade de medicao dos modelos de IA (prompt + completion + cached input). Mais tokens = maior custo.
Como o Faturamento e Calculado#
O sistema aplica a seguinte cadeia de calculo para transformar o custo bruto da API em valor de NF:
Exemplo numerico
Custo API: $94.12
Cambio: 5.4500 → Custo BRL: R$ 512.95
Markup: 30% → Subtotal BRL: R$ 666.84
Imposto NF: 18% → Imposto: R$ 120.03
Total NF: R$ 786.87
Filtros de Periodo#
Use os filtros de data para analisar um periodo especifico:
Filtra automaticamente do primeiro dia do mes atual ate hoje.
Filtra os ultimos 30 dias completos (incluindo hoje).
Remove todos os filtros de data e mostra o historico completo.
Use os campos Inicio e Fim para definir um intervalo de datas manual.
Tabelas de Uso#
Consumo Mensal por Modelo
Agregacao mensal mostrando: mes, provider (OpenAI/Anthropic), modelo (gpt-4o-mini, claude-3-haiku etc.), modo de processamento (chat/batch), chamadas, tokens, custo USD, subtotal BRL, imposto BRL e total NF BRL. Permite comparar custos entre meses e modelos.
Consumo Diario
Detalhamento dia a dia do uso: data, provider, modelo, modo, chamadas, tokens, custo USD e total NF BRL. Ideal para identificar picos de uso ou dias com consumo anomalo.
Exportação CSV#
Clique no botao "Exportar CSV" para baixar todos os dados diarios filtrados em formato CSV, pronto para analise no Excel ou Google Sheets.
O CSV inclui todas as colunas: Data, Provider, Modelo, Modo, Chamadas, Tokens (prompt, cached, completion), Custos (USD e BRL), Cambio, Markup, Imposto e Total NF.
Quem Pode Acessar#
A tela de Consumo de API esta disponivel para usuarios com perfil de gestor ou admin. Operadores nao tem acesso a esta tela.
Acesse via menu: Avatar → Consumo de API ou diretamente em /admin/consumo-api
Checklist
- ✓ KPIs em tempo real: custo USD, total NF, impostos, chamadas/tokens
- ✓ Cálculo automatico: custo API → cambio → markup → imposto → total NF
- ✓ Filtros de periodo: este mes, ultimos 30 dias, personalizado
- ✓ Tabela mensal e diaria com detalhamento por modelo
- ✓ Exportação CSV completa para analise externa
- ✓ Acesso restrito a gestor e admin