Limites de débit
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 :
{
"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 à 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.