FlowModels

Analisar o consumo e exportar em CSV

Publicado em 11. novembro 2026

Em Consumo, você vê quantas chamadas de modelo sua equipe fez, quantos tokens foram processados e quanto isso custou. Os números podem ser filtrados por chave, modelo, usuário final e período e baixados em um arquivo CSV, por exemplo para seu próprio controle de centros de custo.

A página Consumo

No dashboard, abra o item Consumo. A página tem três partes:

  1. No topo aparecem Crédito, Reservado e Disponível, ou seja, a mesma situação de Faturamento.
  2. Abaixo, Histórico por dia mostra as Chamadas ao provedor em barras e o Custo em euros em linha.
  3. A tabela resume tudo por Modelo, com Chamadas ao provedor, Tokens e Valor.

A página Consumo com saldo, filtros, histórico diário e tabela por modelo

São contadas as chamadas ao provedor, incluindo chamadas auxiliares, por exemplo para embeddings e resumos. Por isso, uma requisição da sua aplicação pode gerar mais de uma chamada ao provedor.

Filtrar

Acima do gráfico, há quatro filtros:

  • Todas as chaves: consumo de uma única chave de API, inclusive de uma já bloqueada.
  • Todos os modelos: apenas um modelo específico.
  • Todos os usuários finais: apenas as chamadas de um usuário final da sua aplicação, veja Gerenciar os usuários finais da sua aplicação.
  • Período: o padrão são os últimos 30 dias. No campo de calendário, você escolhe outro período.

Os filtros valem ao mesmo tempo para o gráfico e a tabela. Eles também ficam na barra de endereço, então você pode salvar ou compartilhar uma visualização filtrada como link. A pessoa que abrir o link precisa, é claro, ter acesso ao FlowModels na sua equipe.

Exportar em CSV

  1. Ajuste os filtros conforme os dados que você precisa.
  2. No canto superior direito, clique em Exportar CSV.
  3. O download começa na hora.

O arquivo contém os mesmos dados da visualização, divididos por dia, com as colunas Data, Chave, Usuário final, Modelo, Provedor, Chamadas, Tokens de prompt, Tokens de resposta e Custo EUR. Tokens de prompt são os que você envia ao modelo, e tokens de resposta são os que o modelo retorna.

O link de download vale por poucos minutos e para uma única consulta. Se precisar do arquivo de novo, basta clicar outra vez em Exportar CSV.

Como ler os valores

  • Não faturado ou Estimativa, não faturada: ainda não há preço definitivo para essas chamadas. Elas não estão incluídas nas somas.
  • Preço ainda não disponível: o preço é preenchido assim que estiver definido.
  • Uma linha também pode trazer um aviso como “3 chamadas sem preço definitivo”. Isso não é um erro, apenas indica que parte dos valores ainda está pendente.

Bom saber

  • Se quiser ver cada requisição em vez das somas, use o registro de requisições.
  • O consumo de uma chave no mês em curso também aparece diretamente na lista em Chaves de API, na coluna Consumo.
  • Sua aplicação pode obter os mesmos números com GET /v1/usage. Para isso, basta também uma chave com a permissão Gerenciar chaves.

Este artigo foi útil?

Voltar para Uso e registros