Limites
Os limites de requisições (as chamadas à API e às ferramentas do MCP), de jobs rodando ao mesmo tempo e de duração de cada conta:
| Limite | Valor | Ao passar |
|---|---|---|
| Chamadas por chave ou agente | 1.000 por hora | 429 query_budget_exceeded, com Retry-After |
| Chamadas por organização | 5.000 por hora, somando chaves e agentes | 429 query_budget_exceeded, com Retry-After |
| Rajada por credencial | 600 chamadas em 5 minutos, na API e no MCP | 403 sem corpo JSON, por alguns minutos (Rajadas) |
| Rajada por endereço de origem | 1.000 requisições em 5 minutos, somando o app, a API e o MCP (os blocos do mapa contam à parte) | 403 sem corpo JSON, por alguns minutos (Rajadas) |
| Jobs rodando ao mesmo tempo, por organização | 2, ou o do seu contrato | O job espera em reservado, por ordem de chegada |
| Duração de um job | 12 horas | O job termina falhou; a reserva volta inteira |
| Silêncio de um job | 15 minutos sem sinal de vida | O job termina falhou; a reserva volta inteira |
| Gasto no mês, se a organização definir | O valor escolhido por um admin | 402 spend_limit_reached |
| Réplicas por cenário | 20 | 422 invalid_request (replicas_range) |
| Jobs listados | Os 50 mais recentes | — |
| Retenção de pedido, registro e achados | 365 dias | — |
Idempotency-Key |
1 a 200 caracteres | 422 |
As janelas de chamadas são móveis: contam a última hora a partir de agora, não a hora cheia. Conta toda chamada que a chave ou o agente pode fazer, mesmo que o pedido seja recusado depois (um cenário fora do contrato, por exemplo). Uma chamada sem credencial válida ou sem o escopo não conta. As rotas públicas dos schemas (GET /v1/schemas/cenario-campanha e GET /v1/schemas/pedido-calibracao) não contam.
Rajadas
Seção intitulada “Rajadas”Além do orçamento por hora, dois limites curtos barram as rajadas antes de a chamada chegar à API:
- Por credencial: 600 chamadas em 5 minutos, na API e no MCP, contadas pelo valor do cabeçalho
Authorization. - Por endereço de origem: 1.000 requisições em 5 minutos, somando todas as credenciais e o app que saem do mesmo endereço. Os blocos do mapa da cidade contam à parte.
A chamada barrada recebe 403 sem o corpo JSON de erro e não conta no orçamento por hora. O bloqueio acaba sozinho quando a contagem dos últimos 5 minutos volta para baixo do limite. Espalhe as chamadas: 600 em 5 minutos são duas por segundo.
Precisa de mais? Escreva para suporte@brasilsintetico.com.