Périmètre sûr : Ce guide vise vos propres applications, vos environnements de QA ou de production, ou des systèmes pour lesquels vous détenez une autorisation écrite. Il ne porte pas sur l'automatisation de sites tiers que vous ne contrôlez pas.
Le coût de l'extension CaptchaAI ne dépend pas de la cadence de facturation, mais du nombre de threads que vous provisionnez. Au mois, au semestre ou à l'année, le modèle reste identique : vous payez des threads concurrents, et chaque thread résout un nombre illimité de CAPTCHA. Cette page explique comment lire la grille tarifaire, choisir la bonne cadence et intégrer l'extension.
Comment CaptchaAI facture l'extension
Un thread correspond à un CAPTCHA en cours de traitement : dès qu'une résolution se termine, il se libère pour la suivante. Pas de plafond quotidien, pas de frais par CAPTCHA, pas de surcoût selon le type de défi.
Les plans démarrent à BASIC ($15/mois, 5 threads) et montent par paliers — STANDARD ($30/mois, 15 threads), ADVANCE ($90/mois, 50 threads), PREMIUM ($170/mois, 100 threads) — jusqu'aux paliers CORPORATE, ENTERPRISE et VIP-1 à VIP-3. Votre seul arbitrage réel : le nombre de threads pour absorber votre pic de concurrence.
Mensuel, semestriel ou annuel : que choisir
Les prix ci-dessus sont mensuels. La cadence — mensuel, semestriel ou annuel — ne change pas le modèle par threads : elle porte sur votre engagement et la prévisibilité de votre budget.
- Le mensuel garde une flexibilité maximale : vous ajustez le palier au fil des mois, utile en phase de test ou sur un volume irrégulier.
- Un engagement semestriel ou annuel verrouille le budget plus longtemps et simplifie vos prévisions, une fois le pic connu.
Pour trancher, mesurez votre concurrence réelle sur deux à quatre semaines, puis provisionnez pour le pic, pas pour la moyenne. La grille officielle sur captchaai.com/pricing liste les cadences : les tarifs restent en dollars US.
Architecture d'intégration de l'extension
Votre composant interne appelle l'API CaptchaAI en HTTPS pour récupérer un token, puis l'injecte dans votre formulaire ou votre route d'API. La clé API vit dans un coffre (HashiCorp Vault, AWS Secrets Manager) ou un secret de CI, jamais dans le code source, et se monte en variable d'environnement au runtime. Pour les équipes soumises au RGPD, limitez les données personnelles transitant par ces appels.
Le workflow de résolution, étape par étape
- Capturez uniquement les paramètres utiles (sitekey, URL, action, proxy) : le superflu crée de fausses pistes de débogage.
- Envoyez la tâche à
in.phpavecjson=1; tout statut différent de1est une erreur à journaliser. - Interrogez le résultat sur
res.php: attendez 15 s, puis toutes les 5 s, plafond de 120 s par tâche. - Appliquez le token dans la même session que le défi (même contexte de navigateur, même cookie jar) : une session dépareillée est la première cause de rejet.
- Suivez la latence et l'acceptation en aval : résoudre n'est pas réussir le workflow.
Exemple de code : vérifier le solde
Un appel de solde confirme que la clé est valide et que le compte dispose de crédits 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))
Dépannage
| Symptôme | Cause probable | Correctif |
|---|---|---|
ERROR_WRONG_USER_KEY / ERROR_KEY_DOES_NOT_EXIST |
Clé mal copiée, mauvais compte ou clé régénérée. | Recopiez la clé depuis le tableau de bord et stockez-la comme secret de CI. |
ERROR_ZERO_BALANCE |
Solde inférieur au minimum par tâche. | Rechargez et ajoutez une alerte de solde au tableau de bord. |
ERROR_PAGEURL / ERROR_BAD_PARAMETERS |
Paramètre requis manquant ou mal formé. | Revalidez l'URL, le sitekey et les champs du solveur face au HTML réel. |
| Token refusé après résolution | Token appliqué dans une autre session que celle du défi. | Gardez résolution et soumission dans le même contexte de navigateur. |
FAQ
La facturation CaptchaAI dépend-elle du nombre de CAPTCHA résolus ?
Non. CaptchaAI facture au thread concurrent, résolutions illimitées par thread. Votre coût dépend du nombre de threads provisionnés, pas du volume résolu.
Un engagement annuel est-il moins cher qu'un abonnement mensuel ?
Les tarifs publiés sont mensuels et reposent sur le nombre de threads. La cadence relève surtout de la prévisibilité budgétaire ; consultez captchaai.com/pricing pour les cadences disponibles.
Combien de threads faut-il provisionner pour l'extension ?
Mesurez votre concurrence sur deux à quatre semaines, puis dimensionnez pour le pic. BASIC ($15/mois, 5 threads) suffit à un flux léger ; un pool soutenu justifie ADVANCE ($90/mois, 50 threads) ou plus.
Guides connexes
- Le démarrage rapide de CaptchaAI
- La QA des CAPTCHA en environnement autorisé
- Tester l'endpoint API sur vos formulaires
- Intégrer la résolution de CAPTCHA en CI
- Résoudre reCAPTCHA v2 via l'API
Provisionnez le bon nombre de threads et gardez une facture prévisible d'un mois à l'autre. – Créez votre compte CaptchaAI.
