Périmètre sûr : ce guide vise uniquement vos propres applications et environnements (QA, préproduction, 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.
Les paliers 1 000, 3 000 et 5 000 threads correspondent aux forfaits VIP-1, VIP-2 et VIP-3 de CaptchaAI : trois niveaux pour les équipes à fort volume, sans plafond quotidien. La facturation se fait au thread simultané, pas à la résolution — un thread traite un CAPTCHA à la fois, puis enchaîne le suivant. Pour tenir ces débits, traitez l'extension comme un workflow reproductible : compte stable, profil maîtrisé et token appliqué proprement après résolution.
Ce que couvrent les paliers VIP
Les trois forfaits partagent le même modèle : résolutions illimitées par thread tout le mois, aucun surcoût par type, aucune limite journalière. Seule la concurrence change.
| Forfait | Prix mensuel | Threads simultanés | Résolutions |
|---|---|---|---|
| VIP-1 | $1,500 | 1 000 | Illimitées |
| VIP-2 | $4,500 | 3 000 | Illimitées |
| VIP-3 | $7,500 | 5 000 | Illimitées |
Le débit dépend ensuite de la vitesse de résolution de chaque famille de CAPTCHA et du nombre de threads mobilisés.
Choisir le bon nombre de threads
Le bon palier se raisonne en pic de concurrence, pas en total mensuel. Une agence à Paris ou à Casablanca qui pilote plusieurs campagnes autorisées en parallèle procède en trois temps :
- Instrumentez une semaine de trafic et relevez la concurrence au 95e centile.
- Ajoutez une marge de sécurité au-dessus de ce pic.
- Choisissez le palier au-dessus : VIP-1 (1 000 threads) pour des pics vers 800 résolutions simultanées, VIP-2 ou VIP-3 au-delà, sans refonte du code.
Architecture d'intégration de l'extension
Votre composant interne appelle CaptchaAI en HTTPS pour récupérer un token, puis l'injecte dans le formulaire ou la route d'API qui a déclenché le défi. Point clé : appliquez le token dans la même session que celle qui a demandé le CAPTCHA — même contexte de navigateur, même client HTTP, mêmes cookies. Une session dépareillée fait rejeter le token.
Sécuriser la clé API CaptchaAI
La clé vit dans un coffre (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault) ou dans un secret de CI, jamais dans le code source, puis se monte en variable d'environnement au runtime. Aux volumes VIP, prévoyez une rotation régulière.
Contrôler le solde avant une montée en charge
Avant de basculer sur un palier VIP, un contrôle de solde évite de lancer une campagne sur un compte à sec :
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))
Observabilité et journalisation
Instrumentez les appels CAPTCHA : durée d'obtention du token, code retour HTTP, identifiant de tâche et taille de la file d'attente. Ces signaux distinguent deux mesures souvent confondues : le taux de réussite de résolution et le taux d'acceptation en aval. Côté conformité, appliquez les principes RGPD et minimisez les données personnelles.
Liste de contrôle avant la mise en production
- Le périmètre est limité à vos propres applications ou à des sources autorisées.
- Le palier VIP est dimensionné sur la concurrence de pointe, pas sur un total mensuel.
- La clé CaptchaAI est stockée dans un secret de CI ou un coffre, jamais dans le code.
- Le token est appliqué dans la session qui a déclenché le défi.
- Un retry idempotent avec backoff exponentiel borné est en place.
Dépannage rapide
| Symptôme | Cause probable | Correctif |
|---|---|---|
ERROR_ZERO_BALANCE |
Solde sous le minimum par tâche. | Rechargez et posez une alerte de solde. |
| Token refusé après résolution | Token appliqué dans une autre session. | Résolution et envoi dans la même session. |
ERROR_WRONG_USER_KEY |
Clé mal copiée ou mauvais compte. | Recopiez la clé du tableau de bord. |
Questions fréquentes
Quelle différence entre VIP-1, VIP-2 et VIP-3 ?
Uniquement la concurrence : VIP-1 ($1,500/mois) ouvre 1 000 threads, VIP-2 ($4,500/mois) 3 000 et VIP-3 ($7,500/mois) 5 000. Les trois offrent des résolutions illimitées.
Comment savoir de combien de threads j'ai besoin ?
Mesurez la concurrence de pointe, pas le volume total : relevez les résolutions simultanées (95e centile), ajoutez une marge, choisissez le palier au-dessus.
La facturation au thread inclut-elle des résolutions illimitées ?
Oui. CaptchaAI facture la concurrence, pas la résolution : aucun coût par CAPTCHA ni plafond journalier.
L'extension et l'API partagent-elles le même compte ?
Oui. L'extension et les appels directs à l'API utilisent la même clé, le même compte et le même solde.
Guides connexes
- Le guide de démarrage rapide CaptchaAI
- Résoudre des CAPTCHA en environnement de test autorisé
- Tester l'endpoint de l'API sur vos formulaires
- Intégrer la résolution CAPTCHA dans votre CI
- Résoudre reCAPTCHA v2 via l'API
Passez à l'échelle, du premier thread au palier VIP. – Obtenez votre clé CaptchaAI.
