# Limites de requêtes et de simultanéité

Limites des requêtes, limites des tâches et traitement des réponses 429.

Source : https://scifig.ai/fr/docs/api/rate-limits

## Limites

| Limite | Valeur | S’applique à |
| --- | --- | --- |
| Requêtes de création | 20 par minute | Chaque clé API, ou chaque client OAuth et compte, sur tous les points d’accès `POST` |
| Requêtes de création | 40 par minute | Chaque compte, sur l’ensemble de ses identifiants |
| Requêtes de lecture | 120 par minute | Chaque clé API, ou chaque client OAuth et compte |
| Tâches en cours | Selon l’offre ; voir `GET /credits` | Chaque compte, quota partagé avec le site |
| Tâches par heure | 200 par heure glissante | Chaque compte, quota partagé avec le site |
| Conversions matricielles | 200 par jour | Chaque compte |
| Détections de texte | 20 toutes les 15 minutes | Chaque compte, quota partagé avec le site |
| Attente limitée | 30 secondes | Chaque requête |

## Traitement des réponses 429

- Les réponses aux requêtes ayant passé l’authentification et la vérification de portée contiennent `X-RateLimit-Limit`, `X-RateLimit-Remaining` et `X-RateLimit-Reset` pour la fenêtre de requêtes la plus restrictive. `401` et `403 SCOPE_DENIED` n’en contiennent pas. Une réponse `429` contient `Retry-After` en secondes.
- `429 CONCURRENCY_LIMITED` signifie que trop de tâches sont déjà en cours pour le compte ; les tâches terminées ne comptent plus. Les causes de `429 RATE_LIMITED` sont répertoriées ci-dessous.
- Attendez au moins `Retry-After`, augmentez exponentiellement le délai avec une variation aléatoire et réessayez avec le même `Idempotency-Key`.
- Les limites de tâches s’appliquent au compte : ajouter des clés n’augmente pas la capacité.

## Causes d’une réponse 429

- Trop de requêtes : 20 requêtes de création par minute et par identifiant, 40 par compte, 120 lectures par minute et par identifiant. `Retry-After` indique le délai avant la réinitialisation de la fenêtre ; `details.reason` est absent.
- Trop de tâches ont démarré au cours de la dernière heure : jusqu’à 200 par compte, quota partagé avec le site. `Retry-After: 30`.
- Trop de tâches sont en cours : `429 CONCURRENCY_LIMITED`, selon l’offre et quota partagé avec le site ; voir `GET /credits`. `Retry-After: 30`.
- Le quota quotidien de 200 conversions gratuites PNG, PDF, TIFF et PPTX est épuisé : `details.reason = DAILY_CONVERSION_LIMIT`, avec `Retry-After` jusqu’à la réinitialisation de la fenêtre quotidienne.
- Les importations sont trop rapides : `details.reason = UPLOAD_RATE_LIMITED` pour les images et masques sur `POST /files`, les pièces jointes de diagrammes de flux et les données de graphiques. La limite d’importation par minute du site s’applique.
- Trop d’importations dans la journée : `details.reason = UPLOAD_DAILY_LIMIT_REACHED` pour les pièces jointes de diagrammes de flux et les données de graphiques. La limite quotidienne d’importation du site s’applique.
- Détections de texte : 20 par période de 15 minutes et par compte, quota partagé avec le site.