Erro: Rate Limited

Você atingiu o limite de requisições da API. Aqui está como resolver.

O Que Significa

Error: Rate limit exceeded. Please retry after 60 seconds.

As APIs de IA (Anthropic, OpenAI) limitam quantas requisições você pode fazer por minuto/hora. Isso protege contra uso abusivo e garante disponibilidade.

Causas Comuns

1. Muitas Mensagens Rápidas

Enviou várias mensagens em sequência sem esperar resposta.

2. Loops de Automação

Cron job ou heartbeat mal configurado gerando requisições excessivas.

3. Uso em Múltiplos Dispositivos

Mesmo API key usada em várias instâncias simultaneamente.

4. Tier Baixo da API

Contas novas têm limites mais restritivos.

Limites Típicos

Anthropic (Claude)

OpenAI (GPT-4)

RPM = Requests per minute, TPM = Tokens per minute

Soluções

Solução Imediata

Espere e tente novamente:

O erro diz quanto esperar. Geralmente 30-60 segundos.

Solução de Configuração

Configure retry automático:

# config.yaml
api:
  retry:
    enabled: true
    max_retries: 3
    backoff: exponential

Solução para Automações

Adicione delays:

# Cron com intervalo adequado
heartbeat:
  interval: 5m  # Não menos que 5 minutos

Solução para Alto Volume

Use modelo mais barato para tarefas simples:

models:
  default: claude-3-5-sonnet
  simple: claude-3-haiku  # Rate limits mais altos

Evitar Rate Limits

1. Batching

Agrupe múltiplas perguntas em uma mensagem.

2. Caching

Não repita a mesma pergunta. Use memória.

3. Escalonamento

Distribua requisições ao longo do tempo.

4. Upgrade de Tier

Aumente limite pagando mais na API.

Verificar Status

Uso Atual

# Dashboard Anthropic
https://console.anthropic.com/settings/usage

# Dashboard OpenAI
https://platform.openai.com/usage

Via OpenClaw

"Qual meu uso de API hoje?"

Quando Contatar Suporte

• Limites muito restritivos para seu uso
• Erro persiste mesmo após esperar
• Precisa de limites maiores que Tier 2

Próximos Passos

• FAQ Custos - Entenda os tiers
• Troubleshooting
• Otimização de tokens