Limites de taxa

Cada chave tem uma janela deslizante de 60 segundos. Ao ser excedida a API devolve 429 Too Many Requests.

Plano	Req/min	Chamadas/mês	Lote (receptores)
Free	10	200	—
Starter	30	3.000	100
Pro	100	25.000	500
Business	300	150.000	2.000
Enterprise	1.000	customizado	10.000
Ultra	5.000	customizado	50.000
Carrier (Tier-1)	sob contrato	sob contrato	sob contrato

Tier Carrier (Tier-1 / operadoras nacionais). Quotas, throughput e SLA dimensionados por contrato e fair-scheduling intra-tenant. Inclui deploy dedicado (VPC isolado ou on-premises via Deploy isolado on-prem), NOC 24/7 sob contrato e SLA financeiro negociado. Falar com vendas.

Headers de resposta

• X-RateLimit-Limit — teto de req/min vigente
• X-RateLimit-Remaining — quantas ainda cabem na janela
• Retry-After — presente em respostas 429

Chaves de demo

Cap adicional de 6 req/min independente do tier nominal da chave.

Cobrança de excedente (overage billing)

Equipes (teams) com plano pago e stripe_customer_id configurado podem optar por continuar atendendo requests além da cota mensal em vez de receber 429 Too Many Requests. Cada unidade excedente é cobrada via fatura Stripe out-of-cycle, sem interromper o serviço.

Como ativar:

1. Servidor: a env OVERAGE_BILLING_ENABLED=true precisa estar setada (já está em produção).
2. Time: precisa ter stripe_customer_id (criado automaticamente no primeiro checkout do plano).
3. Tarifa por unidade (configurável via STRIPE_OVERAGE_*_CENTS):

Métrica	Preço por unidade (BRL)
requests	R$ 0,01
pdfs	R$ 0,25
coverage_predict	R$ 0,10
ai	R$ 0,05

Sinalização na resposta:

Quando uma request foi atendida em modo de excedente (acima da cota), a resposta carrega:

X-Overage-Billing: true
X-Quota-Used: 1001
X-Quota-Limit: 1000

Seu SDK pode usar esse header para alertar o operador de que aquela chamada será faturada. Quando o time não está habilitado para overage, o comportamento padrão (429) é preservado.

Para desativar overage para um time específico, remova o stripe_customer_id no portal Admin ou via PATCH /teams/{id} (cache de elegibilidade expira em 60 s).