Limites de taxa

Cada chave de API tem um limite sustentado de requisições por segundo derivado do seu plano (Free 1 req/s → Max 60 req/s — veja Preços). Os limites são aplicados com um token bucket: rajadas de até sua capacidade por minuto são permitidas, e então as requisições são suavizadas para a taxa sustentada.

Quando você é limitado

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429, error: "rate_limited".
retry_after_ms informa o tempo mínimo de espera antes de repetir.
O cabeçalho x-ratelimit-remaining em toda resposta informa quantas requisições restam neste minuto.

Concorrência

Além da taxa por segundo, há um limite de requisições em andamento. Se você dispara muitas requisições de uma vez você pode ver:

409 request_in_progress — uma requisição idempotente idêntica já está em execução.
503 too_many_concurrent_requests — requisições concorrentes em excesso em andamento; faça backoff e repita.

Lidando com limites

Respeite retry_after_ms; caso contrário, use backoff exponencial com jitter.
Mantenha um limite de concorrência no cliente alinhado com a taxa do seu plano.
Os SDKs oficiais repetem 429/503 automaticamente.