FlowModels

Orçamentos e limites: o que vale por chave e o que vale para toda a equipe

Publicado em 11. novembro 2026

No FlowModels, há vários limites que são fáceis de confundir. Alguns valem para uma única chave, outros para a equipe inteira. Aqui você os vê de uma vez só. Vale sempre o limite que for atingido primeiro.

Os limites em resumo

Limite Vale para Onde configurar Erro ao atingir
Limite mensal da chave uma chave Chaves de API → Editar 429 spend_limit_exceeded
Limite de gastos por mês todas as chaves da equipe Faturamento 429 spend_limit_exceeded
Saldo (pré-pago) ou limite de crédito (pós-pago) a equipe inteira Faturamento 429 insufficient_quota
Requisições por minuto equipe, pode ser reduzido por chave Chaves de API → Editar 429 rate_limit_exceeded
Requisições simultâneas a equipe inteira definido pelo nível 429 concurrent_requests_exceeded

Aqui, orçamento sempre se refere a euros, e limite de requisições ao número de chamadas. Os valores em euros são verificados antes da chamada: reservas em aberto de requisições em andamento entram na conta, e uma chamada recusada não custa nada.

Por chave

O limite mensal é definido ao criar ou editar uma chave, como valor inteiro em euros de 1 a 100.000, veja Criar chaves de API. Sem preenchimento, a chave não tem limite próprio. Com isso você separa, por exemplo, um ambiente de testes ou um cliente.

O limite de requisições por minuto também pode ser reduzido por chave, mas nunca acima do limite da equipe. Os detalhes estão em Editar, renovar ou bloquear chaves de API.

Para a equipe inteira

O limite de gastos por mês e os limites de aviso são configurados em Faturamento, veja Configurar o limite de gastos e os alertas. O nível define as requisições por minuto e as requisições simultâneas da equipe inteira, veja Limite de requisições: como funcionam os níveis.

Todos os limites em euros se referem ao mês calendário em curso e recomeçam na virada do mês.

Para os usuários finais da sua aplicação

Não existe orçamento nem limite próprio para usuários finais individuais. Se quiser limitar seus clientes, faça isso na sua aplicação, por exemplo com base nos custos de GET /v1/usage com group_by=end_user, veja Analisar o consumo pela API. Ou dê a cada cliente uma chave própria, com limite mensal próprio.

Qual limite está barrando você

  • 429 insufficient_quota ou credit_balance_exhausted: faça uma recarga de saldo. Aumentar o limite de gastos não resolve neste caso.
  • 429 spend_limit_exceeded ou period_spend_limit_exceeded: o limite mensal da chave ou da equipe foi atingido. Uma recarga não resolve. Aumente o limite ou espere o mês virar.
  • 429 rate_limit_exceeded e 429 concurrent_requests_exceeded: espere os segundos indicados em Retry-After.

Mais sobre os códigos em Entender as mensagens de erro do FlowModels. Sua aplicação pode consultar os valores atuais com GET /v1/key e GET /v1/credits, veja Consultar saldo e limites da chave pela API.

Este artigo foi útil?

Voltar para Saldo e cobrança