Quantas requisições sua equipe pode fazer ao FlowModels depende do nível dela. Toda equipe começa no nível 1 e sobe automaticamente conforme o valor pago aumenta. O nível define dois limites: as requisições por minuto e o número de requisições que podem rodar ao mesmo tempo.
Os quatro níveis
| Nível | Requisições por minuto | Requisições simultâneas | Subida automática a partir de |
|---|---|---|---|
| 1 | 60 | 10 | Início |
| 2 | 600 | 25 | 5 € |
| 3 | 2.000 | 50 | 100 € |
| 4 | 6.000 | 100 | 500 € |
Os dois limites valem para a equipe inteira, ou seja, para todas as chaves somadas.
Onde ver seu nível
No dashboard, abra o item Faturamento. O quadro Limite de solicitações mostra em que nível sua equipe está, quais limites valem e a partir de qual valor você sobe para o próximo nível.

Sua aplicação também pode consultar esses valores: GET /v1/key retorna em limits o nível, o limite efetivo por minuto e as requisições simultâneas permitidas.
Como funciona a subida de nível
- Pré-pago: conta a soma das suas recargas pagas. Estornos são descontados, e créditos concedidos por cortesia não contam.
- Pós-pago: conta o consumo faturado. Equipes que passam para o pós-pago vão direto para o nível 4.
A subida acontece automaticamente, logo após uma recarga paga e também em uma verificação periódica em segundo plano. O nível só sobe, nunca desce sozinho. Se você precisar de um nível mais alto do que seu faturamento atual permite, fale com o suporte.
Limite para uma chave específica
Você pode definir para uma chave um limite próprio de Solicitações por minuto, por exemplo para que um ambiente de testes não consuma toda a cota da equipe. Esse limite só pode reduzir o limite da equipe, nunca aumentar. A configuração fica na edição da chave, veja Editar, renovar ou bloquear chaves de API. Já o limite de requisições simultâneas é sempre compartilhado por todas as chaves da equipe.
O que acontece quando o limite é atingido
A API responde com HTTP 429:
rate_limit_exceeded: a cota por minuto se esgotou, seja a da equipe, seja o limite próprio da chave.concurrent_requests_exceeded: já há tantas requisições rodando ao mesmo tempo quanto seu nível permite.
Nos dois casos, o cabeçalho Retry-After informa o tempo de espera em segundos. Requisições recusadas não custam nada. Implemente na sua aplicação uma repetição com tempo de espera e, em processamentos grandes em lote, envie menos requisições em paralelo. Os demais códigos de erro estão em Entender as mensagens de erro do FlowModels.
Bom saber
As requisições recusadas aparecem no registro de requisições com o status Solicitações em excesso. Se aparecerem muitas, é sinal de que sua aplicação está enviando coisa demais de uma vez ou de que sua equipe precisa de um nível mais alto.