Extension CaptchaAI ou API cloud : comment choisir

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 couvre ni l'automatisation de sites tiers, ni la neutralisation de protections anti-bot.

L'extension CaptchaAI et l'API cloud résolvent les mêmes CAPTCHA, mais pas dans le même contexte. La règle tient en une phrase : prenez l'API cloud dès que la résolution doit tourner sans surveillance (tâche planifiée, worker, CI) ; gardez l'extension pour les sessions interactives.

Extension ou API : deux modes de résolution

L'extension de navigateur s'installe dans Chrome et détecte le défi dans la page : aucun code, elle récupère le token et l'injecte dans la session en cours. C'est le plus rapide en manuel. L'API cloud fonctionne à l'inverse : votre code envoie la tâche, interroge le résultat, puis applique le token dans la session qui a déclenché le défi — le bon choix pour un service headless, un worker ou une exécution en CI.

Les deux couvrent les mêmes types (reCAPTCHA v2 et v3, Turnstile, GeeTest v3, image/OCR, grilles, BLS, plus CaptchaFox, Friendly Captcha et Lemin en bêta) : le choix porte sur où résoudre, pas sur ce que vous résolvez.

L'arbre de décision : quel mode pour quel usage

Posez-vous ces questions dans l'ordre ; la première réponse tranchante décide.

1. Faut-il tourner sans humain devant l'écran ? Tâche planifiée, service serveur, CI : prenez l'API. L'extension suppose un navigateur ouvert.
2. Travaillez-vous en interactif dans un vrai navigateur ? Pour valider un parcours à la main ou reproduire un incident, l'extension évite tout code.
3. Vous faut-il des métriques et des alertes ? L'observabilité fine se branche bien plus simplement côté API.

Les critères qui font pencher la balance

• Environnement. Serveur, conteneur ou CI headless : API. Poste avec navigateur visible : extension possible.
• Débit. L'API parallélise le travail sur plusieurs threads ; l'extension traite un onglet à la fois.
• Coût. La facturation se fait par thread, pas par résolution, avec des résolutions illimitées sur le mois. BASIC ($15/mois, 5 threads) suffit pour un usage QA modéré ; un fort volume monte vers STANDARD ($30/mois, 15 threads) ou ADVANCE ($90/mois, 50 threads). Prix en dollars US.
• Réversibilité. Isolez l'appel derrière une fonction : changer de mode ne réécrit pas votre logique métier.

Exemple : une équipe QA francophone

Une équipe QA en France valide le tunnel d'inscription de sa propre application, protégé par reCAPTCHA v2. À l'exploration, un ingénieur charge l'extension pour repérer où le défi apparaît ; le comportement compris, l'équipe passe à l'API pour rejouer le parcours dans un runner CI européen (eu-west-3, Paris). Les tests portant sur l'application maison, la démarche reste alignée avec le RGPD.

Vérifier le solde avant de lancer un lot

Vérifiez le solde du compte avant un lot de résolutions : un solde à zéro est la cause la plus banale d'un pipeline qui échoue en silence.

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

Branchez cet appel en début de job et déclenchez une alerte sous un seuil plancher.

Observabilité et liste de contrôle

Côté API, instrumentez les appels pour des métriques exploitables : durée d'obtention du token, code retour HTTP et identifiant de tâche, pour vos tableaux de bord de QA. Avant la mise en production, vérifiez que :

• le périmètre reste limité à vos propres applications ou à des sources autorisées ;
• la clé CaptchaAI vit dans un secret CI ou un coffre, jamais dans le code source ;
• le mode colle à l'environnement : API pour le headless et la CI, extension pour l'interactif ;
• un retry idempotent avec backoff exponentiel borné gère les erreurs transitoires.

FAQ

Peut-on combiner l'extension et l'API dans le même projet ?

Oui, et c'est courant : l'extension explore un parcours en interactif, puis l'API prend le relais pour l'exécution automatisée, sur le même compte et les mêmes threads.

L'extension convient-elle à un navigateur automatisé comme Selenium ou Playwright ?

Pour une exécution serveur ou headless, l'API reste plus prévisible : vous maîtrisez la cadence d'interrogation, les retries et la journalisation.

CaptchaAI prend-il en charge hCaptcha ou FunCaptcha ?

Non — ces types ne sont pas encore pris en charge, ni par l'extension ni par l'API. GeeTest v4 est annoncé comme à venir. Vérifiez la liste des types disponibles avant de câbler l'intégration.

Quelle formule choisir pour démarrer ?

Commencez avec BASIC ($15/mois, 5 threads) pour valider votre flux. La facturation étant par thread, vous montez de formule quand le débit simultané l'exige.

Guides connexes

• le démarrage rapide CaptchaAI
• la QA CAPTCHA en environnements autorisés
• tester l'endpoint API sur vos formulaires
• l'intégration 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.