Governança de custos

A governança de custos transforma em valores monetários o registro de uso que preserva a privacidade: administradores declaram quanto custa cada modelo de provedor, o Libre calcula o preço de cada chamada registrada e os orçamentos observam ou limitam os gastos. Nada novo é coletado; o cálculo usa apenas os eventos que o Libre já registra (tokens, unidades, latência, provedor e modelo), que nunca contêm prompts ou respostas.

Tarifas

Uma tarifa é uma linha de preço versionada para um plugin, opcionalmente limitada a um modelo:

• Preço de entrada/saída em USD por milhão de tokens, aplicado às contagens informadas pelo provedor.
• Preço unitário em USD por unidade de saída, aplicado a gerações de mídia (imagens, lotes de fala e vídeos).
• Válida a partir de um horário: tarifas nunca são alteradas. Adicione uma nova linha quando o provedor mudar os preços; cada evento usa a tarifa mais recente vigente no momento em que ocorreu, preservando os custos históricos.

Uma tarifa exata de plugin e modelo prevalece sobre uma linha geral do plugin (sem modelo). Eventos sem tarifa correspondente ou sem uso informado pelo provedor são contados como sem preço e destacados, em vez de receberem silenciosamente custo zero. As contagens do provedor são exatas quando fornecidas; o Libre não insere estimativas no faturamento.

Orçamentos

Um orçamento cobre toda a instância, um usuário ou um grupo durante um dia UTC, uma semana ISO ou um mês do calendário, em um de três modos:

• Observar — aparece somente nas análises.
• Alertar — notifica em 80% e 100% do valor.
• Alertar e bloquear — além dos alertas, bloqueia novas gerações interativas (chat, API compatível com OpenAI, imagens, fala, som, vídeo e edições) com um 429 claro quando o gasto do período chega ao valor.

A associação a grupos é recalculada em cada verificação, e os alertas de limite são enviados exatamente uma vez por orçamento, período e limite por meio da deduplicação de notificações. A aplicação lê um valor de gastos armazenado brevemente em cache, limitando os gastos em cerca de meio minuto do valor real. Qualquer falha na verificação permite a operação: a governança de custos nunca pode derrubar a geração. Automações agendadas são medidas e contam nos gastos, mas somente solicitações interativas são bloqueadas; desative uma automação para interromper seus gastos agendados.

Análise e exportação

Uso → Custos e orçamentos mostra o total calculado no período selecionado, eventos sem preço, gastos por plugin, modelo e usuário, além de cada orçamento com sua utilização atual. Exportar CSV baixa o registro de eventos precificados (horário, usuário, plugin, modelo, capacidade, tokens, unidades e custo) para contabilidade externa. Todos os endpoints de custos são exclusivos de administradores, e cada alteração é registrada na auditoria.