Reconnaissance d'images reCAPTCHA v2

ReCaptchaV2Classification reconnaît les défis d’images de reCAPTCHA v2 : envoyez l’image et l’ID de la question, et vous obtenez les cases à cliquer ; votre programme effectue les clics dans le navigateur. Ce type ne renvoie pas de token. Il est synchrone : une seule requête createTask renvoie le résultat. Une image 3x3 ou 4x4 coûte 6 points (≈ $0.90 / 1k), et une petite image 1x1 coûte moins cher (voir le tableau).

Astuce

Si vous ne voulez pas écrire la logique de clic, utilisez l’extension de navigateur, qui clique automatiquement en s’appuyant sur cette même API.

POSThttps://api.yescaptcha.com/createTaskEndpoint mondialCopier

POSThttps://cn.yescaptcha.com/createTaskEndpoint ChineCopier

Types et tarifs

Type de tâche	Prix	Mode	Remarques
ReCaptchaV2Classification	$0.90 / 1k; 6 points/tâche · ¥6 / 1k	Synchrone	2 points pour une vignette 1x1 (100x100) ; 6 points pour 3x3 (300x300) et 4x4 (450x450)

Les prix en dollars américains sont des estimations avec 1 USD ≈ ¥6.67 ; les tâches sont facturées en points.

Paramètres de la requête

Champ	Type	Obligatoire	Description
type	string	Oui	Type de tâche ; voir « Types de tâches et prix » sur cette page
image	string	Oui	Image de la question encodée en Base64, sans le préfixe data:
question	string	Oui	ID de la question, par exemple /m/0k4j ; voir « ID des questions » sur cette page
confidence	number	Non	Seuil de confiance de 0 à 1, utilisé uniquement pour les images 3x3. S'il est défini (0.5 est un bon point de départ), toutes les cases au-dessus de ce seuil sont renvoyées ; s'il est omis, les 3 cases les plus probables sont renvoyées

Attention

L’image doit être redimensionnée à l’une des tailles standard du tableau ci-dessous : le serveur détermine le type de défi d’après la taille.

Type de défi	Taille de l’image	Retour
Grille 3x3 (« Sélectionnez toutes les images »)	300 × 300	objects : les cases à cliquer
Grille 4x4 (« Sélectionnez toutes les cases »)	450 × 450	objects : les cases à cliquer
Petite image 1x1 (image unique qui apparaît après un clic dans une grille 3x3)	100 × 100	hasObject : cliquer ou non sur cette image

Si vous travaillez avec des captures d’écran, distinguez-les d’après la question : en 3x3, elle commence par « Sélectionnez toutes les images » (Select all images with …) ; en 4x4, par « Sélectionnez toutes les cases » (Select all squares with …).

Exemple de requête

POST https://api.yescaptcha.com/createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "ReCaptchaV2Classification",
    "image": "BASE64_IMAGE",
    "question": "/m/0k4j"
  }
}

Résultat

3x3 et 4x4 :

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "objects": [1, 5, 8],
    "type": "multi"
  },
  "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b"
}

Petite image 1x1 :

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "hasObject": true,
    "type": "single"
  }
}

Champ	Type	Description
objects	array	Indices des cases à cliquer, à partir de 0, de gauche à droite et de haut en bas
hasObject	boolean	Renvoyé pour une vignette 1x1 ; indique si la vignette contient la cible
type	string	Type de question : multi (image 3x3 ou 4x4, voir objects), single (vignette 1x1, voir hasObject) ; drag pour les questions de glisser-déposer de hCaptcha

Les cases sont numérotées à partir de 0, de gauche à droite et de haut en bas :

confidence : obtenir en une fois toutes les cases correspondantes

Après les clics sur une grille 3x3, reCAPTCHA affiche généralement de nouvelles petites images 1x1 qu’il faut encore évaluer. Si elles sont difficiles à récupérer (par exemple en développement mobile), envoyez confidence :

• Sans ce paramètre, une image 3x3 renvoie les 3 cases ayant le meilleur score (reCAPTCHA exige au moins 3 clics).
• Avec ce paramètre (essayez 0.5), toutes les cases dont le score dépasse cette valeur sont renvoyées, soit plus, soit moins de 3 ; un tableau vide si aucune ne correspond. Vous n’avez alors plus besoin de capturer les images 1x1.
• Il n’a aucun effet sur les images 4x4 et 1x1.

ID de questions

question reçoit l’ID de la question (commençant par /m/), et non le texte de la question. L’ID se trouve, avec l’image, dans la réponse de la requête par laquelle reCAPTCHA charge le défi (reload ou userverify). Le tableau ci-dessous liste les questions courantes ; les libellés chinois sont donnés à titre indicatif :

16 au total

ID de la question	Question (anglais)
/m/0pg52	taxis
/m/01bjv	bus
/m/04_sv	motorcycles
/m/013xlm	tractors
/m/01jk_4	chimneys
/m/014xcs	crosswalks
/m/015qff	traffic lights
/m/0199g	bicycles
/m/015qbp	parking meters
/m/0k4j	cars
/m/015kr	bridges
/m/019jd	boats
/m/0cdl1	palm trees
/m/09d_r	mountains or hills
/m/01pns0	fire hydrant
/m/01lynh	stairs

ERROR_UNKNOWN_QUESTION signifie que l’ID est incorrect ou que cette question n’est pas encore prise en charge. ERROR_UNKNOW_450x450_QUESTION signifie que cette question n’est pas encore prise en charge pour les images 4x4 ; rechargez le défi sur la page pour en obtenir un autre.

Signalement et remboursement

Si la vérification échoue après vos clics, vous pouvez signaler les tâches avec report dans un délai de 1 heure ; le remboursement après signalement est réglé environ 24 heures plus tard. Les règles sont décrites dans Facturation et remboursement de points. Si la vérification réussit, signalez-le aussi avec report en envoyant isSuccess: true.

Tutoriels associés

• Reconnaissance d’images reCAPTCHA v2 avec clics simulés (Selenium)
• reCAPTCHA v2 (renvoie un token)