Périmètre sûr : Ce guide s'applique exclusivement à vos propres applications ou à des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne couvre pas l'automatisation de sites tiers ni le franchissement de protections anti-bot.
Pour la plupart des équipes qui exécutent un flux CAPTCHA en production, l'API directe est le choix par défaut : réversible, observable et simple à brancher sur votre intégration continue. L'extension et l'émulateur cloud restent utiles, mais pour des usages précis. Ce guide les compare sur les critères qui comptent — effort d'intégration, latence, coût et réversibilité.
Les trois approches en un coup d'œil
Toutes résolvent des CAPTCHA ; ce qui change, c'est l'endroit où le travail s'exécute et l'effort de maintenance.
| Approche | Idéale pour | Effort d'intégration | Réversibilité |
|---|---|---|---|
| Extension de navigateur | QA manuelle, prototypage | faible | élevée |
| Émulateur cloud | parcours end-to-end à grande échelle | moyen | moyenne |
| API directe | workers planifiés, CI/CD, production | moyen | élevée |
Quand choisir l'extension de navigateur
L'extension s'installe dans le navigateur et résout le défi à la volée, sans écrire de code. Elle est idéale pour la QA exploratoire et les démonstrations pilotées par un opérateur. Sa limite : elle dépend d'un profil de navigateur actif, donc elle convient mal à un worker sans écran.
Quand choisir l'émulateur cloud
L'émulateur cloud fait tourner des navigateurs headless hébergés qui reproduisent un parcours complet, résolution comprise — un réalisme adapté aux parcours end-to-end à fort volume. Hébergez ces navigateurs près de vos utilisateurs — OVHcloud, Scaleway ou une région comme AWS eu-west-3 à Paris — pour limiter la latence. Son coût réel n'est pas la résolution, mais l'infrastructure à maintenir.
Quand choisir l'API directe (recommandé en production)
L'API repose sur deux appels HTTP : vous soumettez la tâche, puis vous interrogez le résultat. C'est l'option la plus réversible et la plus facile à tester, d'où son statut de choix par défaut en production :
- Capturez uniquement ce dont le solveur a besoin : sitekey, URL de la page, action, proxy éventuel.
- Soumettez la tâche à l'endpoint
in.phpavecjson=1; tout statut différent de1est une erreur. - Interrogez le résultat sur
res.php: attendez 15 s, puis toutes les 5 s, avec un plafond de 120 s par tâche. - Appliquez le token dans la même session que celle qui a déclenché le défi, sous peine de rejet.
- Mesurez la latence, les retries et l'acceptation en aval : réussite du solveur et réussite du workflow sont distinctes.
Coût et réversibilité
CaptchaAI facture par thread simultané, avec un nombre illimité de résolutions : pas de facturation à la résolution, pas de surcoût par type. Le plan BASIC ($15/mois, 5 threads) suffit pour valider une intégration ; vous montez ensuite vers STANDARD ($30/mois, 15 threads) ou ADVANCE ($90/mois, 50 threads) selon votre parallélisme. Les vrais gouffres de coût sont les boucles de mauvais paramètres et les tempêtes de retries — pas le type de défi. Privilégiez une implémentation réversible, que vous pourrez abandonner en changeant une seule couche.
Vérifier le solde avant de lancer un lot
Exemple côté client, depuis votre propre suite de tests, pour vérifier le solde avant un lot :
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))
Liste de contrôle avant la mise en production
- Le périmètre est limité à vos propres applications ou à des sources autorisées par écrit.
- La clé CaptchaAI est stockée dans un secret CI ou un coffre, jamais dans le code source.
- Les durées d'appel et les codes retour sont tracés, et un retry avec backoff exponentiel borné couvre les erreurs transitoires.
- Le token est appliqué dans la même session que celle qui a déclenché le défi.
FAQ
Comment choisir entre extension, émulateur cloud et API ?
Partez de l'usage : l'extension pour la QA manuelle, l'émulateur cloud pour les parcours end-to-end à grande échelle, et l'API directe pour les workers planifiés et les pipelines CI/CD.
Peut-on basculer d'une approche à l'autre plus tard ?
Oui, si vous avez isolé la couche de résolution derrière une interface propre dès le départ. Passer de l'extension à l'API se limite alors à remplacer cette couche.
Les prix varient-ils selon le type de CAPTCHA ?
Non. La facturation se fait par thread simultané, avec un nombre illimité de résolutions, quel que soit le type. CaptchaAI couvre reCAPTCHA v2 et v3, Cloudflare Turnstile, GeeTest v3, l'OCR d'images et les grilles ; CaptchaFox, Friendly Captcha et Lemin sont en bêta.
Guides connexes
- Démarrage rapide CaptchaAI
- QA CAPTCHA en environnements autorisés
- Tester l'endpoint API sur vos formulaires
- Intégrer la résolution CAPTCHA en CI
- Résoudre reCAPTCHA v2 via l'API
Améliorez la qualité de vos workflows CAPTCHA avec une approche méthodique et reproductible. – Obtenez votre clé CaptchaAI.
