# Limites de débit de l'API — Limitation par compte et en-têtes

> Les limites de débit v1 s'appliquent par compte, pas par adresse IP, et chaque réponse inclut les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset pour vous permettre de vous auto-limiter avant d'atteindre un HTTP 429.

Les limites de débit sont appliquées par compte authentifié, en fonction de votre clé API — pas par adresse IP. Cela signifie qu'un même client appelant l'API depuis plusieurs machines/IP partage toujours une seule limite, et que différents clients partageant une IP sortante (derrière un proxy d'entreprise, par exemple) ne s'affectent pas mutuellement.

## Limites par catégorie de point d'accès

| Catégorie | Limite | Points d'accès |
| --- | --- | --- |
| Upload / traitement | 30 par minute | POST /documents , POST /batches/{batch_name}/process , POST /documents/{document_id}/bbox , PUT /batches/{batch_name}/webhook |
| Interrogation du statut / résultats | 120 par minute | GET /documents/{document_id} , GET /batches , GET /batches/{batch_name} , GET /batches/{batch_name}/results , GET /documents/{document_id}/bbox , GET /documents/{document_id}/image , GET /account , GET /account/usage , points d'accès des modèles/champs |
| Export | 10 par minute, 60 par heure | GET /batches/{batch_name}/export |

Ces valeurs sont les valeurs par défaut actuelles et peuvent être ajustées au fil du temps ; les en-têtes de réponse décrits ci-dessous reflètent toujours ce qui est réellement en vigueur pour le point d'accès que vous avez appelé. Basez-vous donc sur les en-têtes plutôt que de coder ces nombres en dur.

## En-têtes de réponse

Chaque réponse soumise à une limite de débit — qu'elle soit réussie ou non — comporte trois en-têtes indiquant votre situation :

| En-tête | Signification |
| --- | --- |
| X-RateLimit-Limit | Nombre total de requêtes autorisées dans la fenêtre en cours. |
| X-RateLimit-Remaining | Requêtes restantes dans la fenêtre en cours. |
| X-RateLimit-Reset | Moment où la fenêtre en cours se réinitialise. |

Vérifiez `X-RateLimit-Remaining` de manière proactive dans une boucle d'interrogation et réduisez la cadence avant d'atteindre zéro, plutôt que d'attendre de réagir à un code 429.

## En cas de dépassement d'une limite

Le dépassement d'une limite renvoie un code HTTP 429 avec le format d'erreur standard v1 :

```json
{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Trop de requêtes. Ralentissez et réessayez après la réinitialisation de la fenêtre.",
    "doc_url": "https://imagetotable.ai/developers/guides/errors#rate_limit_exceeded"
  }
}
```

Si vous interrogez l'état d'un lot, préférez l'enregistrement d'un [webhook](/developers/guides/webhooks) à une boucle d'interrogation serrée — cela élimine le risque de déclencher la limite d'interrogation de l'état pour ce cas d'utilisation.

---

Source: https://imagetotable.ai/fr/developers/guides/rate-limits