FlowModels

Configurar o limite de gastos e os alertas

Publicado em 11. novembro 2026

Um loop com defeito na sua aplicação pode disparar muitas chamadas de modelo em pouco tempo. Para isso não pegar você de surpresa, há duas ferramentas: o limite de gastos, que para em um valor fixo por mês, e os limites de aviso, que notificam você a tempo. As duas são configuradas em Faturamento.

Limite de gastos por mês

O limite de gastos vale para a equipe inteira, ou seja, para todas as chaves somadas, e para o mês calendário em curso.

  1. No dashboard, abra o item Faturamento.
  2. No quadro Limite de gastos por mês, informe o valor em Limite em euros, com no máximo duas casas decimais.
  3. Clique em Salvar limite.

Faturamento com o limite de gastos e os limites de aviso

Acima do campo, você vê quanto já foi consumido neste mês, por exemplo “Consumido neste mês: 0,63 € de 20,00 €.” As chamadas em andamento já entram na conta com a reserva delas.

Quando o limite é atingido, a API recusa novas chamadas até o mês virar ou até você aumentar o limite. Sua aplicação recebe então HTTP 429 com um código como spend_limit_exceeded.

  • Deixar o campo vazio: não há limite.
  • Informar 0: nenhuma chamada é mais possível. Isso é prático quando você quer parar a API por completo temporariamente, sem bloquear chaves.

Além disso, você pode dar a cada chave um limite mensal próprio, veja Criar chaves de API: permissão, limite e validade. Vale sempre o limite que for atingido primeiro.

Limites de aviso

Os limites de aviso não param nada, apenas notificam você. Há duas listas, com no máximo 10 valores cada:

  • Valor disponível fica abaixo de: você recebe um aviso quando seu saldo disponível (descontadas as reservas) fica abaixo do valor. Se depois ele voltar a subir, por exemplo com uma recarga, o mesmo limite avisa de novo na próxima vez que o saldo cair abaixo dele.
  • Consumo no mês atinge: você recebe um aviso quando o consumo faturado do mês calendário em curso atinge o valor. Cada limite avisa uma vez por mês.

Como configurar:

  1. Na lista correspondente, clique em Adicionar valor.
  2. Informe o valor em euros, por exemplo 20,00.
  3. Repita para outros valores. Com o X, você remove um valor.
  4. Clique em Salvar limites de aviso.

Notificamos por e-mail, no app e por webhook com o evento credit.threshold, se você tiver configurado um webhook para isso. Como fazer isso está em Configurar webhooks do FlowModels.

Quem recebe os avisos

Em Destinatários aparecem todas as pessoas que recebem os avisos por e-mail: o proprietário da equipe e as pessoas com função administrativa na equipe que têm acesso ao FlowModels. Quem faz parte desse grupo é controlado em Equipe, na barra lateral do FlowModels.

Quando algo não funciona

  • “Informe um valor em euros maior que 0 com no máximo duas casas decimais.”: os limites de aviso precisam ser maiores que 0.
  • “Este valor já está na lista.”: cada valor só pode aparecer uma vez por lista.
  • A recarga não resolve: se o limite de gastos foi atingido, uma recarga não muda nada. Aumente o limite ou espere o mês virar.
  • Não recebi nenhum aviso: verifique se há um endereço em Destinatários. Se aparecer “No momento não há nenhum endereço que possa receber avisos.”, ninguém pode ser avisado por e-mail.

Este artigo foi útil?

Voltar para Saldo e cobrança