Les threads des plans dans l'extension CaptchaAI

Périmètre sûr : ce guide vise vos propres applications et environnements de test, de préproduction ou de production, ou des systèmes que vous êtes autorisé à tester par écrit. Il ne couvre ni l'automatisation de sites tiers, ni la neutralisation de protections tierces.

Un thread, chez CaptchaAI, correspond à un seul CAPTCHA en cours de résolution — ni un abonnement, ni un quota mensuel. Votre plan fixe seulement combien de résolutions tournent en parallèle, de 5 threads avec BASIC ($15/mois, 5 threads) jusqu'à 5 000 avec VIP-3. Comprendre ce modèle évite l'erreur classique : un plan trop large « au cas où », ou trop juste, qui met vos tests en file.

Qu'est-ce qu'un thread dans un plan CaptchaAI ?

Un thread est un emplacement de résolution simultanée. Tant qu'un CAPTCHA l'occupe, il est indisponible ; dès que la résolution se termine, il reprend la tâche suivante. La facturation porte sur ce nombre de threads simultanés, jamais sur le nombre de résolutions : chaque plan offre des résolutions illimitées par thread, sans plafond ni surcoût par type de CAPTCHA.

Le débit réel dépend donc de deux facteurs : la vitesse de résolution de chaque type de CAPTCHA et le nombre de threads du plan.

Front, fournisseur, backend : qui fait quoi

Trois acteurs suffisent à raisonner sur l'intégration :

• Le front déclenche le défi CAPTCHA sur la page.
• Le fournisseur, CaptchaAI via l'extension, détecte le défi et produit le token.
• Votre backend vérifie ce token et applique la décision finale.

C'est là qu'un thread est consommé, le temps de produire le token.

Dimensionner vos threads selon votre charge

Une équipe QA à Lyon rejoue chaque nuit ses tests de bout en bout sur un parcours de connexion protégé par Cloudflare Turnstile. Pour choisir le plan :

1. Comptez les CAPTCHA en vol au même instant, pas le volume de la nuit : 40 sessions parallèles sur un worker OVHcloud, ce sont 40 threads.
2. Écartez les plans qui saturent : STANDARD ($30/mois, 15 threads) met les tâches en file, ADVANCE ($90/mois, 50 threads) absorbe le pic.
3. Ne surdimensionnez pas : un job séquentiel se contente de quelques threads.

Vérifier votre solde et vos threads disponibles

Avant une grosse exécution, vérifiez votre solde par programme pour qu'un compte vide n'interrompe pas la suite :

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))

Déclenchez une alerte sous un seuil de solde et corrélez-la à votre file interne : saturation de threads ou budget épuisé ?

Observabilité et journalisation

Instrumentez chaque appel CAPTCHA pour des métriques exploitables : durée d'obtention du token, code retour HTTP et identifiant de tâche. Ces signaux révèlent une saturation de threads. Séparez les journaux par environnement et reliez chaque identifiant à votre traçage distribué (OpenTelemetry) : vous rejouez un scénario complet depuis un seul identifiant.

Liste de contrôle avant mise en production

• Le nombre de threads couvre votre concurrence réelle, mesurée et non estimée.
• La clé CaptchaAI vit dans un secret CI ou un coffre, jamais dans le code.
• Les durées d'appel et les codes retour sont tracés à chaque exécution.
• Un retry idempotent, avec backoff exponentiel borné, gère les erreurs transitoires.

FAQ

Combien de threads mon plan doit-il inclure ?

Comptez les CAPTCHA résolus en même temps, pas le total quotidien. Une charge séquentielle se contente de BASIC ($15/mois, 5 threads) ; une suite massivement parallèle vise ADVANCE ($90/mois, 50 threads).

Un thread limite-t-il le nombre de résolutions par mois ?

Non. Chaque plan inclut des résolutions illimitées par thread pour le mois de facturation. Le thread borne la simultanéité, pas le volume : un même thread enchaîne des milliers de résolutions, tant qu'elles ne se chevauchent pas.

Que se passe-t-il quand tous mes threads sont occupés ?

Les nouvelles demandes attendent qu'un thread se libère. Vous gérez cette file côté client : plafonnez vos workers au nombre de threads du plan, ou montez de plan si le pic est structurel.

Quels types de CAPTCHA sont pris en charge ?

CaptchaAI résout reCAPTCHA v2 et v3, Cloudflare Turnstile et Challenge, GeeTest v3, ainsi que les CAPTCHA image/OCR, en grille et BLS ; CaptchaFox (bêta), Friendly Captcha (bêta) et Lemin (bêta) complètent la liste. hCaptcha et FunCaptcha (Arkose Labs) ne sont pas pris en charge.

Guides connexes

• Démarrage rapide CaptchaAI
• Résoudre reCAPTCHA v2 via l'API
• QA CAPTCHA en environnements autorisés
• Tester l'endpoint API sur vos formulaires
• Intégration CAPTCHA en continu (CI)

D'un plan choisi au hasard à un dimensionnement mesuré de vos threads. — Obtenez votre clé CaptchaAI.