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

# Limites de débit

> Budgets de requêtes de l'API Retriever par clé et par classe, en-têtes RateLimit et gestion des réponses 429.

## Budgets

Les budgets sont comptés **par clé API** et **par classe de requête**, sur une fenêtre glissante d'une minute. Toutes les clés d'un même utilisateur partagent en plus un plafond égal à 2 fois le budget d'une clé.

| Classe     | Routes                                                    | Défaut par clé                                   |
| ---------- | --------------------------------------------------------- | ------------------------------------------------ |
| `heavy`    | `POST /v1/runs`, `POST /v1/go/run`, `POST /v1/go/runs`    | 30 requêtes / min, 3 requêtes HTTP simultanées   |
| `services` | `POST /services/{serviceName}`                            | 120 requêtes / min, 10 requêtes HTTP simultanées |
| `reads`    | Toutes les autres, dont `GET /services` et `GET /credits` | 600 requêtes / min                               |

* « Simultanées » compte les requêtes HTTP en cours, pas les runs actifs. `POST /v1/runs` répond en quelques millisecondes, donc cette limite gêne peu. `POST /v1/go/run` (synchrone) occupe un slot pendant toute la recherche.
* Avant l'authentification, chaque adresse IP est limitée à 100 requêtes par tranche de 10 secondes.

## En-têtes

Les réponses authentifiées portent :

```http theme={null}
RateLimit-Limit: 600
RateLimit-Remaining: 587
RateLimit-Reset: 42
```

`RateLimit-Reset` est en secondes.

## Réponse 429

Au-delà du budget, l'API répond `429` avec le code `rate_limited` et l'en-tête `Retry-After` (en secondes) :

```json theme={null}
{ "error": { "code": "rate_limited", "message": "Rate limit exceeded. Retry later." } }
```

Attendez `Retry-After` secondes, puis réessayez. Au-delà du parallélisme autorisé, `Retry-After` vaut `1`.

<Tip>
  Les valeurs peuvent être ajustées par l'équipe Retriever. Lisez les en-têtes plutôt que de coder les chiffres en dur.
</Tip>

Pour un client qui applique ces règles, voir [Le client Node commun](/recipes/client).