Pular para o conteúdo

Gasto bloqueado por padrão: o que não foi configurado não libera

Equipe AIUBYRevisado em 16 nov 2026

AI Gateway + pré-pago + planejador do Compute

Toda plataforma que revende capacidade de nuvem tem a mesma pergunta para responder: o que acontece quando falta uma configuração? Na AIUBY, a resposta para dinheiro é sempre a mesma. O que não foi configurado bloqueia, nunca libera. Este texto mostra onde essa regra aparece no caminho de uma chamada de modelo e no planejador do Compute, e onde ela tem exceção.

#A regra

Existem duas formas de tratar um valor ausente. Na primeira, orçamento nulo quer dizer "sem limite", e a conta aparece no fim do mês. Na segunda, orçamento nulo quer dizer "ninguém decidiu ainda", e a chamada não sai. Escolhemos a segunda, e pagamos o preço dela: uma organização nova recebe erros até alguém recarregar e definir os valores. Preferimos esse atrito a uma cobrança que ninguém autorizou.

No Gateway, a decisão acontece antes de qualquer contato com o provedor. Modelo fora da lista do workspace, sem orçamento ou sem preço cadastrado não chega ao provedor.

#Workspace sem orçamento recusa

Cada workspace tem um orçamento mensal. Se a linha não existe, o Gateway não trata como ilimitado: recusa com 403 budget_not_configured. Se existe e acabou, a resposta é 429 budget_exceeded. Zero é um valor válido, e zero bloqueia.

Por isso a tela de orçamento não deixa remover um orçamento, só mudar o valor: sem a linha, o Gateway negaria de qualquer forma, e um campo vazio só confundiria quem olha.

#Pré-pago: sem saldo, sem chamada

O consumo de IA é pré-pago em reais, recarregado por Pix. Uma organização nova começa com saldo zero, e enquanto não houver recarga toda chamada que usa IA recebe esta resposta, com o status HTTP 402:

json
{
  "error": {
    "code": "insufficient_credit",
    "message": "...",
    "request_id": "..."
  }
}

Não há cobrança depois do fato. Quando o saldo acaba, as chamadas param. O valor em reais de cada chamada é gravado pelo banco no momento em que ela fecha, arredondado para cima, e não muda depois. O extrato de créditos só aceita inclusão: um lançamento não é alterado depois.

SituaçãoResposta da API
Workspace sem orçamento definido403 budget_not_configured
Saldo pré-pago zerado402 insufficient_credit
Orçamento do workspace ou de uma regra esgotado429 budget_exceeded
Teto mensal da organização atingido429 org_budget_exceeded

Saldo e orçamento são limites independentes. Sem saldo, a resposta é 402 mesmo com orçamento sobrando.

#A reserva das chamadas em andamento

Conferir o saldo antes de chamar o provedor não basta. Vinte requisições simultâneas veriam o mesmo saldo, todas passariam, e a soma estouraria o limite. O Gateway resolve isso com reserva:

  • A decisão é serializada por workspace e, em seguida, por organização, sempre nessa ordem. Ela termina antes de chamar o provedor.
  • A chamada aprovada é gravada como pendente, com o custo máximo reservado: a entrada estimada mais o max_tokens pedido. Sem max_tokens, a reserva considera 4.096 tokens de saída.
  • Se a rota tem um modelo de reserva, vale o candidato mais caro: a alternativa pode custar mais que o primeiro.
  • O saldo disponível é o crédito menos o já cobrado e menos o reservado. Se não cobre a reserva da chamada nova, a resposta é 402.
  • A reserva de um processo que caiu deixa de contar depois de 15 minutos.

O orçamento do workspace e o teto da organização usam a mesma conta: gasto fechado do mês mais as reservas em andamento. Um teste da suíte dispara chamadas simultâneas contra um saldo pequeno e confere que ele nunca fica negativo.

Limite

A entrada é estimada a 1 token a cada 4 caracteres. Se o provedor contar mais tokens de entrada que a estimativa, a chamada custa mais que a reserva, e só nesse caso o saldo pode fechar abaixo de zero.

#O teto de quem entra pelo catálogo

Quando o dono adiciona o primeiro produto pelo catálogo, a organização nasce com a conta pré-paga em saldo zero, um teto de consumo de IA de US$ 100 por mês, somando todos os workspaces, e um orçamento de US$ 100 em cada workspace. Ninguém precisa lembrar de configurar: o estado inicial já é o fechado.

O teto não é um plano nem um valor cobrado. No pré-pago, quem limita o gasto é o saldo. O teto é a segunda trava, para o caso de uma recarga grande e um laço de chamadas esquecido. O dono baixa o teto e divide o orçamento entre workspaces em Configurações; acima de US$ 100, é com a equipe. Os detalhes estão em Orçamento e modelos liberados.

#O mesmo princípio no Compute

No AIUBY Compute o recurso é outro (contêiner ligado, não token), mas a regra é a mesma, e está escrita na decisão de arquitetura do produto: ausência de configuração nunca vira gasto ilimitado. O planejador de implantação é uma função pura. Ele recebe a configuração pedida e o que se sabe (catálogo, cotas verificadas, tabela de preços, orçamento) e devolve uma lista de bloqueios. Só implanta com a lista vazia.

  • Cota não verificada na conta de nuvem: quota_unverified. Ausente quer dizer não verificada, não disponível.
  • Hardware sem preço na tabela vigente: no_rate_card.
  • Workspace sem orçamento de Compute, ou com orçamento zero: no_budget.
  • Na implantação paga em CPU: conta que não é pré-paga, saldo abaixo do mínimo e teto mensal do workspace nulo ou esgotado são três bloqueios separados.
  • Com a chave geral do runtime desligada, nada é implantável.

O plano pode ser consultado antes, sem criar nada, e mostra os bloqueios. O passo a passo está em Sua primeira aplicação no AIUBY Compute.

#Limites

  • A regra do saldo vale para organização com conta de cobrança. Organizações atendidas pela equipe em uso combinado não têm conta de cobrança em reais: seguem só com o orçamento do workspace, que continua obrigatório.
  • O teto da organização é uma camada a mais. Ele nasce sozinho para quem entra pelo catálogo; nas demais organizações, só existe se a equipe definir.
  • O pay-per-use, com fatura no cartão de crédito, ainda não está disponível. Hoje a única modalidade é o pré-pago.
  • Não há recarga automática: a recarga é sempre um Pix gerado pelo dono na tela.
  • No Compute, a GPU é cobrada por minuto de instância ligada, ociosa ou não, e não pelo tempo em uso como a CPU.

A lista de códigos de erro está em Erros, e as regras de saldo em Cobrança.