FAQ

Les points sont-ils débités quand YesCaptcha ne résout pas un captcha ?

Non. Les tâches en échec (ERROR_CAPTCHA_UNSOLVABLE) ou expirées (ERROR_TASK_TIMEOUT) donnent lieu à un remboursement de points automatique, et les requêtes qui renvoient un code d’erreur (paramètres incorrects, par exemple) ne sont pas débitées. Si vous obtenez un token mais que le site cible le refuse, la tâche est facturée comme réussie, car nous ne pouvons pas connaître la décision du site. Pour la reconnaissance d’images, vous pouvez signaler un mauvais clic afin d’obtenir un remboursement après signalement. Voir Facturation et remboursement de points.

Combien coûte une résolution ?

Chaque type de tâche a un nombre de points fixe débité à chaque résolution (1,000 points = ¥1), et les prix varient selon le type. Tous les prix figurent dans Types de tâches et prix ; la version lisible par machine est disponible à l’adresse /data/task-types.json.

Combien de temps un token reste-t-il valide ?

Les tokens reCAPTCHA, hCaptcha et Turnstile sont à usage unique. Un token reCAPTCHA reste valide environ 120 secondes ; nous vous conseillons de le soumettre dans les 60 secondes suivant sa réception. La durée de validité est fixée par l’éditeur du captcha.

Pourquoi certains tokens ne passent-ils pas ?

C’est le site cible qui décide si un token est accepté. Il tient compte du score, de l’IP, de l’environnement du navigateur, etc., et peut modifier son seuil à tout moment : le taux de réussite varie donc d’un site à l’autre. Vous pouvez comparer avec d’autres types de tâche pour le même captcha, utiliser un type avec votre propre proxy et soumettre le token via ce même proxy, ou passer à la reconnaissance d’images avec de vrais clics dans le navigateur.

Combien de temps dure une résolution ?

Les tâches asynchrones prennent en général de quelques secondes à quelques dizaines de secondes, et au maximum environ 110 secondes (180 à 220 secondes pour quelques types) ; au-delà, elles expirent et les points sont remboursés automatiquement. La reconnaissance d’images et la reconnaissance de texte dans une image sont synchrones : une seule requête renvoie le résultat.

La reconnaissance est-elle humaine ou automatique ?

Automatique, à l’aide de modèles d’apprentissage automatique.

L’utilisation de YesCaptcha peut-elle entraîner le blocage de mon compte ?

Nous ne renvoyons que le résultat de la reconnaissance et n’accédons jamais à votre compte sur le site cible. C’est le site cible qui décide de la façon dont il évalue l’activité et de bloquer ou non un compte ; respectez ses règles. YesCaptcha ne peut être utilisé qu’à des fins légales ; toute utilisation illégale est interdite.

Un même ClientKey peut-il être utilisé simultanément dans plusieurs programmes ou navigateurs ?

Oui. Les requêtes d’un même compte sont comptabilisées ensemble pour la limite de tâches simultanées et partagent le même solde.

Faut-il utiliser l’endpoint mondial ou l’endpoint Chine ?

Si votre serveur se trouve en Chine continentale, utilisez cn.yescaptcha.com ; ailleurs, utilisez api.yescaptcha.com. Interrogez le résultat d’une tâche sur l’endpoint où elle a été créée. Voir Adresses d’accès.

Quelle est la différence entre l’extension de navigateur et l’API ?

L’extension appelle la même API pour résoudre les captchas. Son installation est gratuite et les points sont débités selon les appels d’API utilisés ; elle convient pour travailler dans le navigateur sans écrire de code, alors que l’API convient au traitement par lots dans un programme. Voir Extension de navigateur.

Pourquoi mon compte est-il suspendu avec ERROR_IP_BLOCKED_5MIN ?

Votre ClientKey a généré trop de requêtes en erreur en une minute et fait l’objet d’une suspension automatique de quelques minutes ; elle se lève d’elle-même à l’échéance. Le champ blockReason de la réponse indique le code d’erreur à l’origine de la suspension : corrigez votre programme en conséquence. Voir Limite de tâches simultanées et suspension automatique.

Quels sites sont pris en charge ?

Nous proposons la reconnaissance par type de captcha, et non pour des sites précis. La réussite dépend des paramètres du site cible ; nous vous conseillons de tester d’abord sur un petit lot. Si un site n’est pas encore pris en charge, l’API renvoie ERROR_DOMAIN_NOT_ALLOWED.