Périmètre sûr : Ce guide s'applique exclusivement à vos propres applications, 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.
L'extension CaptchaAI est le moyen le plus rapide de valider le service avant d'écrire du code : installez-la dans Chrome, Edge ou Firefox, ouvrez un formulaire que vous contrôlez, et elle résout le défi CAPTCHA à votre place. Votre compte inclut des crédits pour tester le flux de bout en bout et juger la latence comme la fiabilité sur vos propres pages avant de choisir un plan.
Le piège classique consiste à traiter l'extension comme un bouton à activer une fois. Pour une évaluation fiable, traitez-la comme un workflow de navigateur reproductible : état du compte, profil de navigateur, gestionnaire de CAPTCHA et comportement après résolution. C'est là que se concentrent les surprises, où la méthode supprime l'essentiel des tickets de support.
Pourquoi commencer par l'extension
Un acheteur technique n'a pas besoin d'un projet complet pour trancher. L'extension mesure trois choses en quelques minutes : la latence sur votre famille de CAPTCHA, le taux de réussite sur des pages réelles que vous maîtrisez, et la prise en main pour l'équipe. Cette validation faite, passer à un plan basé sur les threads devient une décision de capacité : la tarification démarre à BASIC ($15/mois, 5 threads), chaque thread traitant un CAPTCHA à la fois avec des résolutions illimitées.
Installer l'extension et activer vos threads de test
Le déroulé reste identique quel que soit le navigateur :
- Créez votre compte et récupérez votre clé API : c'est elle qui relie l'extension à votre solde.
- Installez l'extension depuis le magasin de votre navigateur, puis collez-y votre clé.
- Ouvrez une page de test que vous contrôlez — un formulaire de préproduction ou de QA interne — et déclenchez le CAPTCHA.
- Laissez l'extension résoudre le défi, puis vérifiez que le token est accepté. Ce premier solve consomme vos crédits de test, pas un thread payant.
Du premier clic à l'intégration API
L'extension valide le principe ; l'API industrialise le flux, dans le même ordre :
- Capturez uniquement ce dont le solveur a besoin : sitekey, URL de la page, action, proxy éventuel.
- Envoyez la tâche, puis interrogez le résultat : 15 secondes d'attente, puis toutes les 5 secondes, plafond de 120 secondes par tâche.
- Appliquez le token dans la même session que celle qui a déclenché le défi — même contexte de navigateur, même client HTTP, même cookie jar. Une session dépareillée est la première cause de rejet.
- Tracez la latence, les retries et l'acceptation en aval, plafonnez les retries à trois avec un backoff exponentiel borné et alertez sur l'écart entre solve et acceptation.
Mesurer la réussite de l'intégration
Les chiffres qui suivent 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. Suivez la latence du premier solve (p50 sous 25 s pour les CAPTCHA à token, sous 8 s pour l'OCR d'image), le taux de réussite par famille et l'acceptation de bout en bout après le token.
Exemple de code
Exemple côté client de 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))
Observabilité et journalisation
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. Séparez les journaux par environnement et corrélez les identifiants à votre traçage distribué, par exemple OpenTelemetry : vous rejouerez un scénario complet à partir d'un identifiant unique.
FAQ
L'extension CaptchaAI est-elle gratuite pour tester ?
L'installation est gratuite et votre compte inclut des crédits pour valider le flux. Vous réussissez ainsi un premier solve sur vos propres pages avant de souscrire un plan basé sur les threads.
Sur quels navigateurs l'extension fonctionne-t-elle ?
Sur Chrome, Edge et Firefox. Vous collez votre clé API dans ses réglages, puis elle résout le défi dans l'onglet, sans code.
Quels CAPTCHA l'extension prend-elle en charge ?
Les familles courantes : reCAPTCHA v2 et v3, Cloudflare Turnstile et Cloudflare Challenge, GeeTest v3, plus les CAPTCHA image/OCR et en grille. hCaptcha et FunCaptcha ne sont pas pris en charge, et GeeTest v4 est à venir.
Ce guide concerne-t-il l'automatisation de sites tiers ?
Non. Tous les exemples portent sur vos propres applications ou des environnements de test autorisés par écrit. Validez les conditions d'utilisation et la base juridique avant d'automatiser une source externe.
Guides connexes
- Le guide de démarrage rapide CaptchaAI
- La QA CAPTCHA en environnements autorisés
- Tester l'endpoint API sur vos formulaires
- Intégrer la résolution de CAPTCHA en CI
- Résoudre reCAPTCHA v2 via l'API
Passez de l'essai à la production avec une méthode reproductible. – Obtenez votre clé CaptchaAI.