File d’attente et limites

File d’attenteCopy Anchor Link

• Jusqu’à 10 tâches par compte sont traitées en même temps.
• Jusqu’à 30 tâches attendent derrière elles dans la file. Pendant qu’une tâche attend, GET /edits/{id} renvoie sa queue_position (tâches qui attendent devant elle ; les tâches en cours ne comptent pas, donc 0 signifie qu’elle démarre ensuite) et estimated_seconds (notre estimation de sa fin).
• Quand 30 tâches attendent déjà, POST /edits renvoie 503 queue_full avec un en-tête Retry-After. Rien n’est facturé.
• Une tâche peut tourner jusqu’à 10 minutes après sa sortie de la file. Le temps d’attente ne compte pas : avec une file pleine, la dernière tâche peut prendre environ 30 minutes dans le pire des cas. La plupart des tâches se terminent en 1 à 2 minutes, 9 sur 10 en 3 minutes.

Limites de débitCopy Anchor Link

Chaque compte, partagé par toutes ses clés, peut faire sur toute fenêtre glissante de 60 secondes :

Toute requête avec une clé valide compte, y compris celles rejetées avec une erreur. Les requêtes sans clé ou avec une clé invalide ne comptent pour aucun compte.

Le dépassement renvoie 429 rate_limited avec Retry-After, toujours un nombre entier de secondes : le temps avant que la plus ancienne requête de la fenêtre n’expire. GET /account renvoie vos limites actuelles dans limits. Les comptes Entreprise peuvent avoir des limites plus élevées.

InterrogationCopy Anchor Link

• Tant qu’une tâche est processing, ou queued avec queue_position à 0, interrogez GET /edits/{id} toutes les 5 secondes.
• Tant qu’elle est queued plus loin, vérifiez toutes les 30 secondes. estimated_seconds indique quand la tâche devrait se terminer, pas quand vérifier.

Avec 10 tâches en cours et 30 en file, cela fait au plus 190 lectures par minute, sous la limite de 240. Pour éviter toute interrogation, passez callback_url et recevez un webhook.

ImagesCopy Anchor Link

• JPEG, PNG ou WebP, jusqu’à 20 Mo, côté le plus long jusqu’à 8000 px.
• Envoyez-la comme image_url, image_base64, fichier image en multipart ou image_id d’un appel OCR précédent — exactement un seul par requête.
• Jusqu’à 20 remplacements par modification.

Voir Images pour l’encodage de chaque méthode d’envoi, l’EXIF, la transparence et les fichiers de résultat.

Nouvelles tentatives sûresCopy Anchor Link

Envoyez un en-tête Idempotency-Key avec chaque POST /edits pour pouvoir réessayer sans risque après un délai dépassé ou une erreur réseau. Répéter la même clé dans les 24 heures renvoie 202 avec l’id de la tâche d’origine et son statut actuel (elle peut déjà être processing ou terminée) au lieu d’en créer — et d’en facturer — une nouvelle, même si le corps diffère. Les clés sont propres au compte et partagées par toutes ses clés d’API. Une requête rejetée (tout 4xx ou 5xx) ne consomme pas sa clé : vous pouvez la renvoyer avec la même clé après correction.