Limites de Uso
Entenda os rate limits e como monitorar seu uso.
Limites por Endpoint
| Categoria | Endpoint | Limite | Janela |
|---|---|---|---|
| 🤖 IA - Texto | /api/ia/generate/text |
10 req | por minuto |
| 🖼️ IA - Imagem | /api/ia/generate/image |
3 req | por minuto |
| ⛏️ Minecraft | /api/minecraft/* |
60 req | por minuto |
| 📊 Status | /api/status |
60 req | por minuto |
💡 Os limites são aplicados por IP de origem. Se você usar proxy ou VPN, o limite é compartilhado com outros usuários do mesmo IP.
Headers de Rate Limit
Todas as respostas da API incluem headers que permitem monitorar seu uso:
X-RateLimit-Limit
Número máximo de requisições permitidas na janela atual.
X-RateLimit-Remaining
Número de requisições restantes na janela atual.
X-RateLimit-Reset
Timestamp Unix indicando quando a janela será resetada.
Retry-After
Presente apenas quando o limite é excedido (429). Indica segundos para aguardar.
Exemplo de Resposta
HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 10
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1702656000
{"text": "Resposta gerada pela IA..."}Quando o Limite é Excedido
Se você exceder o limite, receberá um erro 429 Too Many Requests:
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 45
{"detail": "Rate limit exceeded. Retry after 45 seconds."}Boas Práticas
- ✅ Implemente retry com backoff exponencial
- ✅ Monitore os headers
X-RateLimit-* - ✅ Cache respostas quando possível
- ✅ Distribua requisições ao longo do tempo
Precisa de Mais?
Para aplicações de alto volume ou necessidades especiais, entre em contato para discutir limites personalizados.
Saiba Mais Sobre Nós