Skip to main content
Use orçamentos de workspace e limites de chaves de API para controlar os gastos. Uma organização compartilha um único saldo de conta; os limites de workspace e de chave restringem o uso de cada um.

Definir um orçamento

  1. Entre no workspace. Um administrador abre as configurações de orçamento dele.
  2. Escolha um período e um valor e selecione limite rígido ou somente alerta.
  3. Configure os limites de alerta e os destinatários válidos, se houver. Salve e verifique o uso atual.
Um limite rígido impede o uso além da cota. Uma configuração de somente alerta notifica os destinatários sem bloquear, por si só, as solicitações ao atingir o limite de alerta.

Períodos e redefinições

As redefinições usam UTC, independentemente do fuso horário do seu navegador. Alterar um valor ou período não apaga o uso real. Definir um limite abaixo do uso já realizado afeta imediatamente a cota restante.

Como os limites funcionam em conjunto

  • Uma chave tem um valor e um período. Um valor 0 significa sem limite no nível da chave.
  • Um limite de workspace não definido significa que nenhum limite foi configurado nesse nível, e não uma cota zero.
  • Uma chave sem limite ainda precisa de cota no workspace e de saldo suficiente na conta.
  • Esgotar o saldo da conta, um limite rígido do workspace ou um limite de chave restringe as solicitações.
Esgotar uma cota interrompe as solicitações em andamento com um erro. O uso real antes da interrupção continua sendo cobrado. Verifique o resultado e o custo nos logs de solicitações.

Quando um limite é atingido

Identifique qual limite se aplica. Um administrador pode adicionar créditos quando o saldo for insuficiente. Para um limite periódico, aguarde a redefinição ou peça a uma pessoa autorizada que o ajuste. Trocar de chave não remove um limite rígido do mesmo workspace. Um alerta de orçamento não adiciona cota. Use a análise de uso para investigar as principais origens dos gastos. Última atualização: 2026-10-13