Types de CAPTCHA pris en charge par l'extension CaptchaAI

Périmètre sûr : ce guide s'applique uniquement à vos propres applications et à vos environnements de QA, de préproduction ou de production, ou à des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne porte pas sur l'automatisation de sites tiers que vous ne contrôlez pas.

L'extension CaptchaAI résout les principales familles de CAPTCHA directement dans le navigateur : reCAPTCHA, Cloudflare Turnstile et Challenge, GeeTest v3, images et grilles. Cette page recense la matrice exacte — types pris en charge, en bêta et à venir — à citer en revue de code.

Ce que l'extension prend en charge

Le service couvre 12 types en disponibilité générale et 3 en bêta. Les types en « bêta » fonctionnent mais restent en déploiement : ne leur associez pas de taux de réussite sans une mesure datée. hCaptcha et FunCaptcha ne sont pas traités, et GeeTest v4 est annoncé mais pas encore disponible.

Appliquer le token, étape par étape

1. Capturez uniquement les paramètres attendus par la famille de CAPTCHA : sitekey, URL de la page, action, proxy.
2. Envoyez la tâche, puis interrogez le résultat avec la même boucle quel que soit le type ; seule la méthode change d'une famille à l'autre.
3. Injectez le token dans la même session que celle qui a déclenché le défi : même contexte de navigateur, même cookie jar. Une session dépareillée est la première cause de rejet.
4. Mesurez la latence et l'acceptation en aval, pas seulement la réussite du solveur.

Vérifier le solde avant un lot

Contrôlez le solde avant un traitement par lots, pour qu'une tâche n'échoue pas sur un solde nul. Exemple côté client, extrait de votre 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))

Surveiller l'intégration

Journalisation et secrets

La clé CaptchaAI vit dans un coffre (Vault, AWS Secrets Manager, Azure Key Vault) ou un secret de CI, jamais dans le code source. Séparez les journaux par environnement et corrélez chaque appel à un identifiant de tâche. Côté RGPD, limitez les données personnelles qui transitent par vos logs.

Liste de contrôle avant la mise en production

• Le périmètre reste limité à vos propres applications ou à des sources autorisées.
• La clé CaptchaAI est stockée dans un coffre ou un secret de CI, jamais en clair.
• Un retry idempotent avec backoff exponentiel borné couvre les erreurs transitoires.
• La réussite de la résolution et celle du workflow sont mesurées séparément.

FAQ

L'extension gère-t-elle hCaptcha et FunCaptcha ?

Non — pas encore pris en charge. CaptchaAI ne résout ni hCaptcha ni FunCaptcha (Arkose Labs). Vos scripts peuvent détecter ces défis, mais prévoyez une branche de repli dans votre workflow.

Quels types sont en bêta ?

CaptchaFox, Friendly Captcha et Lemin sont en bêta. Ils fonctionnent, mais leur déploiement se poursuit et aucun taux de réussite daté n'est publié. Testez-les avant de les placer sur un chemin critique.

La facturation dépend-elle du type de CAPTCHA ?

Non. CaptchaAI facture par thread, avec des résolutions illimitées par thread sur le mois : aucun surcoût selon la famille. À partir de BASIC ($15/mois, 5 threads), ajoutez des threads pour traiter plus de défis en parallèle.

Pourquoi mon token est-il refusé après résolution ?

Presque toujours parce qu'il est appliqué dans une session différente de celle qui a affiché le défi. Gardez la résolution et la soumission du formulaire dans le même contexte de navigateur, avec le même cookie jar.

Guides connexes

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

Passez de la matrice à la pratique sur votre propre famille de CAPTCHA. – Obtenez votre clé CaptchaAI.