Périmètre sûr : Ce guide porte uniquement sur vos propres applications et environnements (QA, préproduction, production) ou des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne couvre pas l'automatisation de sites tiers sans accord.
L'extension CaptchaAI et l'API headless coûtent le même prix. La facturation se fait au thread concurrent, pas à la résolution : extension dans un navigateur ou worker sans interface, vous puisez dans le même quota de threads. La vraie question n'est donc pas « laquelle est la moins chère », mais « laquelle correspond à votre volume et à votre workflow ».
Même prix : tout se facture au thread
CaptchaAI facture la capacité, pas le nombre de résolutions. Un thread correspond à une résolution en cours ; il se libère dès qu'elle se termine. Chaque forfait inclut un nombre de threads fixe et des résolutions illimitées : BASIC ($15/mois, 5 threads) suffit à un pipeline de QA modeste, et la gamme monte jusqu'à ENTERPRISE ($300/mois, 200 threads).
Conséquence directe : l'extension et l'API headless consomment le même compteur. Ni surcoût par type de CAPTCHA, ni frais par intégration, ni plafond quotidien. Passer de l'une à l'autre ne change pas votre facture ; seul le nombre de threads provisionnés la fait varier.
Volume différent : ce que traite chaque surface
Ce qui sépare les deux surfaces, c'est le débit et le mode d'exécution.
L'extension de navigateur vit dans une session Chrome réelle : idéale pour les parcours interactifs et la QA de votre propre application, avec l'état de session et les cookies déjà en place. Son débit reste borné par le nombre d'onglets qu'un poste peut tenir.
L'API headless s'appelle depuis un script, un worker planifié ou un pipeline CI, sans interface graphique. C'est la surface des volumes élevés et non surveillés : autant de résolutions concurrentes que vos threads le permettent.
Quelle surface pour quel workflow
Le choix se ramène à trois questions :
- Un navigateur réel avec session ouverte est-il nécessaire ?
- Quel est le volume concurrent au pic ?
- L'exécution est-elle supervisée ou non ?
| Critère | Extension | API headless |
|---|---|---|
| Contexte | Navigateur réel, session existante | Script, worker, CI/CD |
| Volume typique | Faible à moyen, interactif | Élevé, concurrent |
| Supervision | Manuelle ou semi-automatique | Non surveillée |
| Prix | Au thread (identique) | Au thread (identique) |
Une équipe qui valide un formulaire protégé par reCAPTCHA v2 en tests exploratoires prendra l'extension ; quand elle les industrialise dans son pipeline d'intégration continue, elle bascule vers l'API sans toucher au forfait.
Vérifier votre solde avant de dimensionner
Avant d'augmenter le nombre de threads, mesurez votre consommation réelle. Un appel à l'API de solde alimente une alerte ou un tableau de bord :
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))
Suivez-le en continu : une baisse plus rapide que prévu trahit souvent une boucle de retry ou de mauvais paramètres.
Observabilité et journalisation
Quelle que soit la surface, instrumentez les appels CAPTCHA : 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 reliez chaque identifiant à votre traçage distribué (OpenTelemetry) pour rejouer un scénario complet.
Liste de contrôle
- Le périmètre reste limité à vos propres applications ou à des sources autorisées.
- La clé CaptchaAI est stockée dans un secret CI ou un coffre, jamais dans le code source.
- Le nombre de threads est dimensionné sur votre pic de concurrence, pas sur le volume total.
- Le basculement extension ↔ API reste possible sans réécrire le cœur de votre code.
FAQ
L'extension et l'API headless ont-elles le même prix ?
Oui. Les deux puisent dans le même quota de threads, avec des résolutions illimitées. La surface choisie n'a aucun effet sur la facture ; seul le nombre de threads provisionnés compte.
Combien de threads faut-il provisionner ?
Dimensionnez-les sur votre pic de concurrence, pas sur le total. Cinq threads (BASIC, $15/mois) absorbent un pipeline de QA léger ; montez en gamme quand plusieurs workers tournent en parallèle.
Quand privilégier l'extension plutôt que l'API ?
Prenez l'extension quand le workflow exige un navigateur réel et une session déjà ouverte : tests exploratoires, QA interactive. La même clé valant pour les deux surfaces, passez à l'API dès que le volume ou l'exécution non surveillée domine.
Le type de CAPTCHA change-t-il le prix ?
Non. Le tarif reste au thread quel que soit le type : reCAPTCHA v2, reCAPTCHA v3 ou Cloudflare Turnstile passent par le même quota. Vous changez de type ou de surface sans toucher au forfait.
Guides connexes
- Le démarrage rapide CaptchaAI
- La QA CAPTCHA en environnements autorisés
- Tester l'endpoint API sur vos formulaires
Dimensionnez vos threads sur votre volume réel, quelle que soit la surface. – Obtenez votre clé CaptchaAI.
