# Reconnaissance d'images reCAPTCHA v2

> Reconnaissez les défis d'images reCAPTCHA v2 avec YesCaptcha (ReCaptchaV2Classification) : envoyez une image 3x3, 4x4 ou 1x1 avec l'ID de la question et recevez de façon synchrone les cases à cliquer ; tarif selon la taille de l'image ; table des ID de questions.

Source: https://docs.yescaptcha.com/fr/tasks/recaptcha-classification/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/tasks/recaptcha-classification/

`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](https://docs.yescaptcha.com/fr/extension.md), qui clique automatiquement en s’appuyant sur cette même API.

- POST `https://api.yescaptcha.com/createTask` (Endpoint mondial)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint Chine)

## 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

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

## Résultat

3x3 et 4x4 :

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

Petite image 1x1 :

```json
{
  "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 :

![Numéros de cases 0 à 8 d’une grille 3x3](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![Numéros de cases 0 à 15 d’une grille 4x4](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## 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` |

Aucune question correspondante

`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](https://docs.yescaptcha.com/fr/api/report.md) 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](https://docs.yescaptcha.com/fr/getting-started/billing.md). 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)](https://docs.yescaptcha.com/fr/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (renvoie un token)](https://docs.yescaptcha.com/fr/tasks/recaptcha-v2.md)