Gasto bloqueado por padrão: o que não foi configurado não libera
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:
{
"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ção | Resposta da API |
|---|---|
| Workspace sem orçamento definido | 403 budget_not_configured |
| Saldo pré-pago zerado | 402 insufficient_credit |
| Orçamento do workspace ou de uma regra esgotado | 429 budget_exceeded |
| Teto mensal da organização atingido | 429 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_tokenspedido. Semmax_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
#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.


