Périmètre sûr : ce guide s'applique exclusivement à vos propres applications, à vos environnements de QA, de préproduction ou de production, ou à des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne décrit ni l'automatisation de sites tiers, ni le contournement de protections, ni l'évasion d'anti-bot.
Le nombre de threads que vous réservez fixe deux choses à la fois : votre débit maximal de résolutions simultanées et le montant de votre abonnement mensuel. Trop de threads, vous payez une capacité qui dort ; pas assez, vos tâches s'empilent en file d'attente et l'API finit par renvoyer ERROR_NO_SLOT_AVAILABLE. La bonne nouvelle : ce chiffre se calcule, il ne se devine pas. À partir de votre volume réel et de votre temps de résolution moyen, une seule formule vous donne le plan à viser.
Comment CaptchaAI facture : au thread, pas à la résolution
CaptchaAI facture par thread concurrent, jamais à la résolution. Un thread correspond à un CAPTCHA en cours de traitement ; dès qu'une résolution se termine, le thread se libère et prend la tâche suivante. Chaque plan inclut un nombre illimité de résolutions par thread sur le mois, sans quota journalier, sans frais par type de CAPTCHA et sans surcoût selon la famille traitée.
Votre seule variable de dimensionnement est donc le nombre de threads. La grille officielle va du plan BASIC ($15/mois, 5 threads) au plan VIP-3 ($7,500/mois, 5 000 threads), avec entre les deux STANDARD ($30/mois, 15 threads), ADVANCE ($90/mois, 50 threads), PREMIUM ($170/mois, 100 threads), CORPORATE ($240/mois, 150 threads) et ENTERPRISE ($300/mois, 200 threads). Le débit n'est plafonné que par la vitesse de résolution propre à chaque type de CAPTCHA et par le nombre de threads alloués.
La formule pour dimensionner vos threads
Un thread reste occupé pendant toute la durée d'une résolution. Le nombre de threads nécessaires découle donc directement de votre débit de pointe et de votre temps de résolution moyen :
threads requis = résolutions par minute (pic) × temps de résolution moyen (en secondes) / 60
Si vous raisonnez à la seconde plutôt qu'à la minute, la formule se simplifie :
threads requis = résolutions par seconde (pic) × temps de résolution moyen (en secondes)
Deux paramètres à mesurer sur votre propre trafic, jamais à supposer : le pic de résolutions (pas la moyenne lissée sur la journée, qui masque les rushs) et le temps de résolution moyen observé pour votre type de CAPTCHA. Un CAPTCHA image en OCR se résout en quelques secondes ; un défi à token de type reCAPTCHA ou Turnstile occupe le thread plus longtemps. Mesurez ces deux valeurs avant de choisir un plan.
Un exemple chiffré
Les chiffres ci-dessous reposent sur des mesures observées et des retours d'utilisateurs. Les résultats varient selon l'environnement, le volume et le moment de la journée.
Prenons une équipe QA e-commerce basée à Lyon qui rejoue chaque nuit une campagne de tests de checkout en préproduction. En pointe, la suite déclenche 120 résolutions par minute, et ses propres mesures donnent un temps de résolution moyen de 15 s sur le type de CAPTCHA de son parcours.
Application de la formule : 120 × 15 / 60 = 30 threads. Le plan ADVANCE ($90/mois, 50 threads) couvre ce besoin avec une marge confortable, là où un plan STANDARD (15 threads) placerait la moitié des tâches en file d'attente pendant le pic. Gardez toujours une réserve de 20 à 30 % au-dessus du calcul brut : les pics réels dépassent presque toujours la moyenne théorique, et une file qui déborde coûte plus cher qu'une poignée de threads inutilisés.
Surveiller la consommation réelle
Le calcul donne un point de départ ; la production le corrige. Instrumentez vos appels pour comparer, chaque semaine, le nombre de threads réservés au nombre réellement utilisé en pointe. Un simple contrôle du solde et de l'activité suffit à repérer une dérive avant qu'elle ne bloque une exécution.
Exemple côté client, à intégrer dans votre propre suite de tests :
import os
import requests
API_KEY = os.environ['CAPTCHAAI_KEY']
def get_balance() -> float:
resp = requests.post(
'https://api.captchaai.com/getBalance',
json={'clientKey': API_KEY},
timeout=15,
)
resp.raise_for_status()
return float(resp.json().get('balance', 0))
Stockez la clé CaptchaAI dans un coffre (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault) ou dans un secret CI, jamais dans le code source ; le déploiement la monte en variable d'environnement au runtime.
Observabilité et journalisation
Quel que soit le langage, instrumentez les appels CAPTCHA pour obtenir des métriques exploitables : durée d'obtention du token, code retour HTTP, identifiant de tâche et taille de la file d'attente interne. Ces signaux révèlent les moments où vous saturez vos threads et justifient une montée de plan par des chiffres plutôt que par intuition.
Séparez les journaux par environnement (développement, préproduction, production) et corrélez les identifiants à votre traçage distribué, par exemple via OpenTelemetry. Vous pourrez alors rejouer un scénario complet à partir d'un identifiant unique, ce qui divise par deux le temps de diagnostic en cas d'incident.
Liste de contrôle avant de choisir un plan
- Le pic de résolutions par minute est mesuré sur le trafic réel, pas estimé.
- Le temps de résolution moyen est relevé pour votre type de CAPTCHA précis.
- La formule est appliquée, puis majorée de 20 à 30 % de réserve.
- Le plan retenu offre au moins le nombre de threads calculé (voir la grille officielle).
- La clé CaptchaAI est stockée dans un secret CI ou un coffre, jamais en clair.
- Le solde et l'usage réel des threads sont suivis chaque semaine.
- Une stratégie de retry idempotent est en place pour les erreurs transitoires.
FAQ
Comment savoir combien de threads il me faut ?
Multipliez votre pic de résolutions par minute par votre temps de résolution moyen en secondes, puis divisez par 60. Le résultat est votre plancher de threads ; ajoutez 20 à 30 % de réserve pour absorber les pointes, puis choisissez le plan dont le nombre de threads couvre ce total.
Que se passe-t-il si je réserve trop peu de threads ?
Vos tâches passent en file d'attente et, en cas de saturation prolongée, l'API renvoie ERROR_NO_SLOT_AVAILABLE. Le débit chute pendant les pics, sans que la qualité de résolution soit en cause. C'est le signal qu'il faut monter d'un palier de threads.
Le nombre de threads change-t-il selon le type de CAPTCHA ?
Le tarif reste le même par thread, quel que soit le type. Ce qui change, c'est le temps d'occupation : un CAPTCHA image en OCR libère le thread en quelques secondes, un défi à token le garde plus longtemps. C'est ce temps moyen, mesuré chez vous, qui pilote le calcul.
Puis-je changer de plan quand mon volume évolue ?
Oui. Le dimensionnement des threads n'est pas figé : suivez l'écart entre threads réservés et threads réellement utilisés en pointe, et ajustez le plan lorsque cet écart se réduit durablement ou qu'une file d'attente apparaît.
Guides connexes
- le guide de démarrage rapide CaptchaAI
- la QA CAPTCHA en environnements autorisés
- tester l'endpoint API sur vos propres formulaires
- intégrer la résolution CAPTCHA à votre CI
- résoudre reCAPTCHA v2 via l'API
Dimensionnez vos threads sur des mesures réelles plutôt qu'au jugé. – Créez votre compte CaptchaAI.
