A fatura de IA que ninguém olha: como governar o gasto em OpenAI, Anthropic, Copilot e Cursor

Há dois anos, o gasto em IA de uma empresa era um cartão de crédito com uma subscrição do ChatGPT. Hoje são várias chaves de API em produção, um projeto da OpenAI por equipa, lugares de GitHub Copilot e de Cursor, e programadores que pagam o seu próprio plano de Claude ou de ChatGPT e o apresentam como despesa. Cada peça fatura por si, na sua consola e com o seu ciclo. Neste artigo mostramos como juntar tudo no AAA Sentinel, passo a passo e com um exemplo completo.

Porque é que a IA se tornou a nova fatura descontrolada

A fatura de IA tem os mesmos defeitos que a fatura cloud tinha há dez anos, e mais alguns:

• Paga-se por utilização e sem teto por omissão: um ciclo mal escrito ou um agente que repete sem fim pode gastar num dia o que antes se gastava num mês.
• Está espalhada por fornecedores que não falam entre si: OpenAI, Anthropic, GitHub e Cursor têm cada um a sua consola, a sua forma de agrupar e o seu próprio conceito de orçamento.
• Uma parte não passa por nenhuma consola da empresa: as subscrições individuais só aparecem nas despesas de cada pessoa.
• As alavancas de poupança são técnicas e pouco conhecidas: a cache de prompt, a API de lotes ou escolher um modelo mais pequeno poupam muito, mas só se alguém olhar para os dados de consumo.

O que ganha com isso

Com o gasto de IA ligado e vigiado, várias coisas mudam:

• Vê o gasto de todos os fornecedores num só sítio, separando o que o fornecedor já faturou do que ainda é uma estimativa.
• Sabe que projeto ou workspace gasta, e não só quanto gasta a organização.
• Recebe recomendações de eficiência concretas, com a poupança máxima que podem dar a preço de tabela.
• Fica a saber antes de esgotar um limite de gasto, e não quando o fornecedor começa a rejeitar pedidos em produção.
• Tem inventariadas as contas individuais da sua equipa e o respetivo preço de tabela.

Como o AAA Sentinel o resolve

Tudo vive em Conexões → «Conexões de IA» e assenta nestas peças:

• Conexões de organização: uma credencial de administração por fornecedor, com a qual a plataforma lê todos os dias o consumo e o custo faturado.
• Conexões individuais: a conta de uma pessoa (o email, o plano e o dia de renovação), sem guardar nenhuma chave.
• Regras de IA: cada conexão é avaliada com um conjunto de regras de eficiência, governo e anomalia que geram descobertas com a respetiva poupança máxima.
• Alertas: os picos de gasto e os limites prestes a esgotar saem pelos mesmos canais que os alertas das suas nuvens.
• Agente: no Business, com uma chave de escrita à parte, o agente pode propor limites, alertas ou revogações, sempre com aprovação humana.
• Agente de uso: uma CLI para o portátil que reporta o uso das contas individuais de Cursor, Claude Code, Copilot e Codex.

Caso prático: a ACME e o seu gasto de IA

A ACME é uma empresa fictícia com plano Business. Tem dois projetos na OpenAI, um workspace na Anthropic e seis programadores com subscrições próprias. Este foi o seu gasto de setembro, que usaremos no resto do artigo:

Passo 1: ligar a OpenAI e a Anthropic com uma Admin API Key

Vá a «Conexões de IA» e carregue em «Conectar provedor de IA». O assistente tem quatro ecrãs:

• Escolha o fornecedor: OpenAI ou Anthropic.
• Em «Organização ou individual?», escolha «Organização».
• «Passo 1 — Crie uma chave somente leitura»: a ligação leva-o à página de chaves de administração do fornecedor. Na OpenAI é uma Admin API Key da organização; na Anthropic, uma Admin Key da consola. Uma chave de API normal, das que se usam para chamar o modelo, não serve. Quando a tiver, carregue em «Já tenho a chave».
• «Passo 2 — Conecte a chave»: preencha «Nome da conexão» (por exemplo, OpenAI Produção), cole a chave em «Chave de API (somente leitura)» e, se quiser, o «ID da organização», opcional nestes dois fornecedores. Carregue em «Conectar».

Passo 2: Copilot, Cursor e OpenRouter (Business)

As conexões de organização destes três fornecedores exigem o plano Business, porque as regras que avaliam são de governo. Cada um pede uma credencial diferente:

• GitHub Copilot: um token de acesso pessoal clássico com a permissão manage_billing:copilot ou read:org, criado por um proprietário da organização. O «ID da organização» é obrigatório: é o login da organização no GitHub.
• Cursor: uma chave de API de administrador do painel do Cursor, com o scope admin:*, criada por um administrador da equipa.
• OpenRouter: uma Management API Key, diferente das chaves de inferência. Em vez do ID da organização pede o «ID do workspace», obrigatório: é o workspace cujo orçamento vai ser lido e, se ativar a escrita, ajustado.

Passo 3: as contas individuais

Para os planos pessoais da sua equipa, escolha «Individual» no segundo passo do assistente. Não é pedida nenhuma chave: só «Email do titular», «Plano do provedor», «Dia de renovação» (de 1 a 28) e, se gere clientes, a quem pertence. A plataforma guarda o «Preço de tabela» do plano segundo o seu catálogo e soma-o ao inventário.

• Na ficha de uma conta individual, «Uso declarado» permite registar a percentagem da quota consumida em cada período de renovação. É a forma mais simples de saber se um plano caro está a ser aproveitado.
• Na lista de «Conexões de IA», o bloco «Pessoas» junta as conexões individuais do mesmo email.
• A plataforma avisa se a mesma pessoa tiver duas conexões individuais do mesmo fornecedor, ou se também aparecer na conexão de organização: o sintoma típico de pagar duas vezes pelo mesmo.

Passo 4: ler a ficha de uma conexão

Ao abrir uma conexão de organização vai encontrar:

• «Custo faturado» e «Custo estimado», sempre em separado: o primeiro é o valor que o fornecedor já confirmou; o segundo, uma estimativa própria do que ainda não faturou. Nunca se somam num mesmo número.
• «Evolução diária»: o gasto dia a dia no «Período» que escolher. É onde se vê um pico antes de chegar à fatura.
• «Detalhamento»: o gasto por atribuição, que na OpenAI é o projeto e na Anthropic o workspace. É o que lhe diz quem gasta.
• «Escrita do agente»: o sítio onde ativar, ou revogar, a chave de escrita do Passo 7.

Passo 5: o que detetam as regras de eficiência (Pro)

As regras de eficiência leem os tokens por modelo dentro de cada projeto ou workspace. São estas, com os limiares reais:

• AI-001, cache pouco aproveitada (OpenAI e Anthropic): há escritas em cache, mas menos de 20 % da entrada é servida a partir dela, com pelo menos 100.000 tokens de entrada.
• AI-002, candidato à API de lotes (OpenAI e Anthropic): pelo menos 2 milhões de tokens durante 7 dias ou mais no nível de serviço standard. A API de lotes fatura cerca de metade.
• AI-003, janela de contexto sobredimensionada (só Anthropic): consumo na janela de 200.000 a 1 milhão de tokens com saídas inferiores a 2 % da entrada.
• AI-004, modelo caro para uma tarefa simples (OpenAI, Anthropic, Cursor e OpenRouter): um modelo de gama alta cuja saída não chega a 10 % da entrada.
• AI-005, escrita de cache não amortizada (OpenAI e Anthropic): pelo menos 50.000 tokens escritos em cache e menos de uma leitura por cada token escrito.

As regras de governo e anomalia (Business)

O Business acrescenta regras que não procuram eficiência, mas sim a falta de uma salvaguarda ou algo que dispara:

• AI-010 e AI-011: há gasto real, cerca de 10 USD/mês ou mais extrapolados a partir de pelo menos 7 dias, sem nenhum limite rígido (AI-010) ou sem nenhum alerta de gasto (AI-011).
• AI-012: uma chave de API da OpenAI, Anthropic ou OpenRouter sem atividade há 30 dias ou mais.
• AI-013, AI-014 e AI-015 (Cursor): gasto de pessoas que saíram da equipa; utilizadores sem limite mensal, com pelo menos 10 USD de consumo por utilização no ciclo e acima da média da equipa; e gasto no grupo «Unassigned», sem grupo de faturação.
• AI-016 e AI-017 (Copilot): um orçamento de Copilot não trava a cobrança das licenças de lugar; e lugares sem atividade há 30 dias ou mais (a data depende da telemetria do IDE, por isso é um indício, não uma certeza).
• AI-020: um dia cujo gasto triplica a média dos dias anteriores, com pelo menos 7 dias de base; a partir de seis vezes a média, com severidade alta.
• AI-021 (Cursor): os agentes automáticos levam 15 % ou mais do gasto da equipa e pelo menos 50 USD/mês.
• AI-022: o gasto do período do limite (o mês, ou na OpenRouter também a semana ou o último dia completo) já está a 80 % ou esgotou-o, ou a projeção para o fim do mês ultrapassa-o.

Passo 6: ser avisado antes de esgotar o limite

O AAA Sentinel não inventa um orçamento próprio para a IA: lê o limite que já tem configurado no fornecedor (o limite de um projeto ou da organização na OpenAI, o orçamento do Copilot ou o do workspace na OpenRouter) e compara-o todos os dias com o gasto do mês. Na OpenRouter, que admite ao mesmo tempo um orçamento diário, semanal e mensal, compara cada um com o gasto do seu próprio período (o último dia completo, desde segunda-feira ou desde o dia 1, em UTC); o orçamento vitalício não é medido. A regra AI-022 dispara em três casos: o gasto já está a 80 % do limite; depois de pelo menos 5 dias com dados, a projeção para o fim do mês ultrapassa-o; ou o limite está esgotado, o que sobe para severidade alta porque o fornecedor pode estar a rejeitar pedidos (exceto o orçamento diário da OpenRouter, que se mede com o dia já fechado).

• O aviso chega como alerta de orçamento de IA pelos canais configurados em Alertas → «Canais de alerta» (email, Slack, Microsoft Teams ou webhook), com o interruptor «Picos de despesa» ativo, o mesmo que governa os picos da AI-020.
• Na ACME, etl-resumos tem um limite de 1.300 USD na OpenAI. A 10 de outubro já leva 520 USD: a este ritmo fechará o mês em 520 ÷ 10 × 31 = 1.612 USD, acima do limite. O alerta chega nesse dia, com três semanas de margem.

Passo 7: deixar o agente agir por si (Business)

A chave de leitura nunca serve para alterar nada. Se quiser que o agente possa corrigir, na ficha da conexão, em «Escrita do agente», cole uma segunda chave com permissões de escrita e carregue em «Ativar escrita». Pode ser revogada a qualquer momento sem afetar a recolha. Estas são as ações que existem hoje por fornecedor:

• Todas as ações de IA exigem aprovação humana: nenhuma é executada em piloto automático. Depois da aprovação há um período de carência antes da execução, por exemplo 24 horas para o limite de um projeto da OpenAI, 48 para o de toda a organização ou para revogar um lugar de Copilot e 72 para revogar uma chave.
• Revogar uma chave na OpenAI ou na OpenRouter é irreversível, e o agente não revoga chaves com menos de 30 dias.
• Na ACME, a AI-010 sobre suporte-bot leva o agente a propor um limite para esse projeto; um aprovador indica o valor, aprova e, passadas 24 horas, o limite fica definido na OpenAI.

Passo 8: o agente de uso no portátil

As contas individuais não têm API de consumo. Para saber quanto são usadas, o AAA Sentinel oferece uma CLI que lê a atividade local de Cursor, Claude Code, Copilot e Codex. O guia completo está em Desenvolvedor → «Agente de uso». Na ficha de uma conexão individual de Cursor, Anthropic, Copilot ou OpenAI, carregue em «Inscrever»: o token é mostrado uma única vez. Depois, no portátil dessa pessoa:

npm install -g @aaa-sentinel/ai-usage

sentinel-usage login < token.txt

Get-Content -Raw -Encoding utf8 token.txt | sentinel-usage login

sentinel-usage status
sentinel-usage logout

• O token entra pela entrada padrão, nunca como argumento, para não ficar no histórico do shell. O login deixa o relatório agendado ao iniciar sessão e de hora a hora.
• Só envia o dia, o modelo e os contadores (turnos, tokens ou pedidos). O prompt, o código, a conversa e o caminho do transcript não saem do portátil.
• O Copilot é lido através do gh e dá pedidos premium por modelo, sem tokens. O Codex só é lido quando o login é a subscrição do ChatGPT: se usar uma API key, esse gasto pertence à conexão de organização.
• Esses números não são convertidos em dólares nem somados ao faturado ou estimado: servem para saber se um plano está a ser aproveitado.

O que ainda não faz

Para que saiba o que esperar:

• Não há um orçamento de IA definido dentro do AAA Sentinel: os alertas de orçamento comparam com o limite configurado no fornecedor.
• Na Anthropic, o agente não pode criar alertas nem limites de gasto, porque a sua Admin API não o permite fora do Claude Enterprise. A AI-010 e a AI-011 ficam como guia manual.
• A conexão individual da OpenRouter ainda não pode ser criada.
• A poupança das regras de eficiência é um teto a preço de tabela: a real pode ser menor, e sem um teto garantido a regra avisa sem valor.
• O uso reportado pela CLI não tem valor monetário: o Copilot não dá tokens e o Cursor só dá contadores se o seu hook os trouxer.

Checklist para começar

Com isto a funcionar, a fatura de IA deixa de ser uma surpresa de fim de mês:

• Plano Pro para OpenAI ou Anthropic; Business para Copilot, Cursor ou OpenRouter, para as regras de governo e para o agente.
• Uma Admin API Key por fornecedor, ligada a partir de «Conexões de IA».
• As contas individuais da sua equipa registadas, com o plano e o dia de renovação.
• Um limite de gasto configurado em cada fornecedor que o permita, e o interruptor «Picos de despesa» ativo em «Canais de alerta».
• A «Escrita do agente» ativada só nas conexões em que quer que o agente proponha alterações.
• O agente de uso instalado nos portáteis com planos caros.