Limites e acesso

Em Configurações → Limites e acesso (Settings → Limits & access), no console, você gerencia em um só lugar os orçamentos e as regras de acesso de toda a equipe. Assim evita gastos inesperados e impede o uso indevido caso uma API Key vaze.

Regra	Efeito	Onde configurar
Limite de gastos	Interrompe as chamadas quando o limite é atingido	Equipe, membros: Limites e acesso; key: API Keys
Lista de permissões de IP	Permite chamadas apenas de servidores específicos	Equipe: Limites e acesso; key: menu da key → lista de permissões de IP (IP Whitelist)
Modelos permitidos	Define quais modelos podem ser chamados	Equipe: Limites e acesso; key: menu da key → Modelos permitidos (Allowed models)
Taxa de requisições	Requisições por minuto compartilhadas por todas as keys da equipe	Somente leitura; veja Limites de taxa

Somente proprietários e administradores da equipe podem alterar essas regras. Cada alteração fica registrada em Histórico de alterações (Change history), no canto superior direito da página.

Limites de gastos

Os orçamentos têm três níveis: equipe, membro e API Key. O período pode ser Diário (Daily), Mensal (Monthly) ou Total (Total).

Orçamento da equipe: teto de gastos da equipe inteira
Orçamento padrão dos membros: calculado para cada membro separadamente; se um membro tiver um orçamento próprio, vale o orçamento próprio
Orçamento da key: definido para uma key específica na página API Keys

Os três níveis são calculados de forma independente. Se qualquer um deles se esgotar, a requisição é bloqueada. Dentro do mesmo período, o orçamento de uma key não pode passar do orçamento do membro ao qual ela pertence, e o orçamento de um membro não pode passar do orçamento da equipe.

Para cada orçamento, escolha o que acontece:

Modo	Ao atingir o limite
Notificar e bloquear (Notify and block)	Envia um alerta por e-mail e interrompe as chamadas
Apenas notificar (Notify only)	Apenas envia o alerta por e-mail, sem bloquear

Depois que o orçamento se esgota, recarregar não restabelece as chamadas. É preciso aumentar o limite ou aguardar o reinício do período diário / mensal.

Lista de permissões de IP

Permite chamadas apenas de endereços IPv4 ou faixas CIDR específicos, com até 100 entradas. Requisições de fora da lista são recusadas.

Lista de permissões de IP da equipe: vale para todas as API Keys da equipe
Lista de permissões de IP da key: restringe ainda mais uma key específica, a partir da lista da equipe; os endereços da lista da key só têm efeito se também estiverem na lista da equipe

Ideal para prender as keys de produção aos seus próprios servidores: mesmo que uma key vaze, ninguém consegue usá-la de outro lugar.

Modelos permitidos

A equipe pode escolher entre três modos, com seleção em lote por provedor:

Modo	Descrição
Todos os modelos (All models)	Todos os modelos podem ser chamados, inclusive os que forem lançados no futuro
Apenas estes modelos (Only these models)	Só os modelos da lista podem ser chamados; os lançados no futuro também ficam de fora
Bloquear estes modelos (Block these models)	Os modelos da lista não podem ser chamados; os demais não são afetados

Cada key também pode ser restringida ainda mais no menu da key, em Modelos permitidos (Allowed models). As regras da equipe e da key valem ao mesmo tempo: só podem ser chamados os modelos permitidos pelos dois lados.

Verificar regras efetivas

Uma key está sujeita às regras da equipe e às da própria key ao mesmo tempo. Em API Keys, abra o menu da key, clique em Verificar regras efetivas (Check effective rules) e escolha um modelo para ver se a chamada seria bloqueada, por qual regra e quanto ainda resta do orçamento. A verificação não consome créditos.

Respostas quando a requisição é bloqueada

Requisições barradas por um orçamento ou por uma regra de acesso não terão sucesso ao repetir; ajuste a regra primeiro:

Código de status	Código de erro	Causa	Como resolver
`402`	`spending_limit_exceeded`	Limite de gastos da equipe, do membro ou da key excedido	Aumentar o limite ou aguardar o reinício do período
`402`	`insufficient_credits`	Saldo insuficiente	Recarregar
`403`	`ip_not_allowed`	O IP de origem não está na lista de permissões de IP	Adicionar o IP à lista de permissões da equipe ou da key
`403`	`model_not_allowed`	A equipe ou a key não permite este modelo	Usar outro modelo ou ajustar os modelos permitidos
`503`	`spending_limit_check_unavailable`	Não foi possível verificar o orçamento no momento	Tentar novamente mais tarde

As requisições bloqueadas aparecem em Atividade (Activity) com o filtro Bloqueadas (Blocked). A lista completa de códigos de erro está em Tratamento de erros.

Histórico de alterações

Na lista de permissões de IP, nos modelos permitidos e nos orçamentos, quem alterou o quê e quando pode ser consultado em Histórico de alterações (Change history), no canto superior direito de Limites e acesso. As configurações de retenção de logs não são registradas aqui; veja Logs de requisições.