Périmètre sûr : Ce guide s'applique exclusivement à vos propres applications ou à des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne décrit ni l'automatisation de sites tiers, ni le contournement de protections.
L'erreur « No Threads Available » de l'extension CaptchaAI signifie que tous les threads de votre offre sont déjà occupés quand l'extension tente une nouvelle résolution. Ce n'est ni un bug ni une clé API invalide, mais une limite de capacité. La corriger revient à libérer des threads, à réduire votre concurrence, ou à passer à une offre plus large.
Ce que signifie « No Threads Available »
CaptchaAI facture au thread : un thread correspond à une résolution en cours. Sur l'offre BASIC ($15/mois, 5 threads), cinq résolutions tournent en parallèle et la sixième attend qu'un thread se libère. Dès que vos onglets ou workers dépassent ce plafond au même instant, l'extension renvoie « No Threads Available » : un signal de saturation, pas une panne.
Les causes les plus fréquentes
- Plusieurs profils de navigateur partagent la même clé API et consomment les threads en parallèle.
- Une automatisation côté serveur tourne déjà sur cette clé pendant que vous utilisez l'extension.
- Un lot de tests QA lancé en parallèle sur OVHcloud ou Scaleway épuise les cinq threads d'un coup.
Corriger l'erreur étape par étape
Reprenez le contrôle de votre capacité dans cet ordre :
- Recensez ce qui consomme vos threads. Listez chaque profil, script et worker sur la même clé API ; c'est souvent une résolution serveur oubliée qui monopolise le pool.
- Fermez les sessions inactives. Un onglet figé garde son thread ouvert jusqu'au timeout ; le terminer libère la capacité.
- Bornez votre concurrence. Ne lancez jamais plus de résolutions simultanées que votre offre n'a de threads ; une file d'attente interne lisse les pics.
- Ajoutez un retry avec backoff. Traitez l'erreur comme transitoire et réessayez après quelques secondes.
- Montez d'offre si besoin. Si votre volume dépasse durablement cinq threads, STANDARD ($30/mois, 15 threads) ou ADVANCE ($90/mois, 50 threads) élèvent le plafond.
Vérifier votre solde et vos threads
Confirmez d'abord que le blocage vient de la concurrence et non d'un solde épuisé. Cet appel côté client lit le solde associé à votre clé :
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))
Un solde à zéro produit d'autres codes d'erreur, pas « No Threads Available » ; le vérifier écarte une fausse piste.
Tableau de dépannage
| Symptôme | Cause probable | Correctif |
|---|---|---|
| « No Threads Available » récurrent | Concurrence au-dessus du plafond | Bornez vos workers ou montez d'offre |
| Erreur persistante après inactivité | Thread retenu par un onglet figé | Fermez les sessions inactives |
| Saturation soudaine en production | Automatisation serveur partageant la clé | Isolez la clé de l'extension et de l'API |
| Pics de charge récurrents | Charge non lissée | File d'attente et retry avec backoff |
Observabilité et journalisation
Instrumentez chaque appel CAPTCHA pour rendre la saturation visible avant qu'elle ne bloque un workflow : durée d'obtention du token, code retour HTTP et, surtout, nombre de threads actifs. Séparez les journaux par environnement et alertez dès que la concurrence approche votre plafond.
Liste de contrôle
- La concurrence totale reste sous le plafond de threads de votre offre.
- Les sessions inactives libèrent leur thread au lieu de le retenir jusqu'au timeout.
- La clé CaptchaAI est stockée dans un secret CI ou un coffre, jamais dans le code source.
- « No Threads Available » est traité comme une erreur transitoire, avec retry et backoff borné.
- Le nombre de threads actifs est tracé et alerté par environnement.
FAQ
« No Threads Available » veut-il dire que mon solde est épuisé ?
Non. Il signale que tous vos threads sont occupés simultanément, pas que votre compte est vide ; un solde épuisé renvoie plutôt ERROR_ZERO_BALANCE.
Combien de threads propose l'offre la plus accessible ?
BASIC ($15/mois, 5 threads) permet cinq résolutions en parallèle. Chaque thread traite un nombre illimité de résolutions dans le mois ; seule la concurrence est plafonnée.
Faut-il réessayer automatiquement après cette erreur ?
Oui. Un retry avec backoff exponentiel borné (trois tentatives, plafond à 30 secondes) suffit le plus souvent, le temps qu'un thread se libère.
L'extension et l'API partagent-elles les mêmes threads ?
Oui, si elles utilisent la même clé API : les threads sont comptabilisés au niveau du compte, et automatisation serveur et extension puisent dans le même pool. Isolez-les ou augmentez votre capacité.
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
Libérez de la capacité et tracez vos threads : « No Threads Available » disparaît de vos logs. – Créez votre compte CaptchaAI.
