> ## Documentation Index
> Fetch the complete documentation index at: https://cut.pro/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Limites de requisição

> Como funciona o rate limit da API e como lidar com o status 429

A API aplica um limite de requisições para proteger a plataforma.

## O limite

* **1500 requisições por minuto**, por endereço IP
* A janela é de **60 segundos**

Esse limite é generoso para o uso normal, incluindo o polling de submissões e renders. Se você roda muitos processos a partir do mesmo IP, distribua as chamadas ao longo do tempo.

## Quando o limite é atingido

Ao ultrapassar o limite, a API responde com:

* Status **`429 Too Many Requests`**
* Header **`Retry-After`** com o número de **segundos** que você deve esperar
* Corpo: `{ "code": "RATE_LIMIT_EXCEEDED" }`

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 60

{ "code": "RATE_LIMIT_EXCEEDED" }
```

## Como lidar

* **Respeite o `Retry-After`**: espere o número de segundos indicado antes de tentar de novo
* **Use backoff** em caso de chamadas repetidas, em vez de tentar imediatamente
* **Espace o polling**: ao acompanhar uma submissão ou um render, consulte em intervalos de alguns segundos em vez de em loop apertado

<Note>
  A API não retorna headers `X-RateLimit-*`. Use o status `429` e o `Retry-After` para detectar e tratar o limite.
</Note>