# Reconocimiento de imágenes de reCAPTCHA v2

> Resuelve los desafíos de imágenes de reCAPTCHA v2 con YesCaptcha (ReCaptchaV2Classification): sube una imagen 3x3, 4x4 o 1x1 con el ID de la pregunta y recibe de forma síncrona las celdas que debes pulsar; precio según el tamaño de la imagen y tabla de IDs de preguntas.

Source: https://docs.yescaptcha.com/es/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` reconoce los desafíos de imágenes de reCAPTCHA v2: envías la imagen y el ID de la pregunta, y recibes qué celdas hay que pulsar; tu programa hace los clics en el navegador. **No devuelve un token**. Es síncrono: una sola solicitud `createTask` devuelve el resultado. Cada imagen 3x3 o 4x4 cuesta 6 puntos (≈ $0.90 / 1k), y la imagen pequeña 1x1 es más barata (consulta la tabla).

> **Consejo:** Si no quieres escribir la lógica de clics, usa la [extensión del navegador](https://docs.yescaptcha.com/es/extension.md), que hace los clics automáticamente con esta misma API.

- POST `https://api.yescaptcha.com/createTask` (Endpoint global)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint China)

## Tipos y precios

| Tipo de tarea | Precio | Modo | Notas |
| --- | --- | --- | --- |
| `ReCaptchaV2Classification` | $0.90 / 1k; 6 puntos/tarea · ¥6 / 1k | Síncrono | 2 puntos por una imagen de 1x1 (100x100); 6 puntos por 3x3 (300x300) y 4x4 (450x450) |

Los precios en dólares son estimaciones con US$1 ≈ ¥6.67; las tareas se cobran en puntos.

## Parámetros de la solicitud

| Campo | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `type` | string | Sí | Tipo de tarea; consulta "Tipos de tarea y precios" en esta página |
| `image` | string | Sí | Imagen del desafío codificada en Base64, sin el prefijo `data:` |
| `question` | string | Sí | ID de la pregunta, como `/m/0k4j`; consulta "ID de preguntas" en esta página |
| `confidence` | number | No | Umbral de confianza de 0 a 1, solo se usa para imágenes de 3x3. Si lo envías (0.5 es un buen punto de partida), se devuelven todas las celdas por encima del umbral; si lo omites, se devuelven las 3 celdas más probables |

> **Precaución:** La imagen debe escalarse a uno de los tamaños estándar de la tabla; el servidor determina el tipo de desafío por el tamaño.

| Tipo de desafío | Tamaño de la imagen | Devuelve |
| --- | --- | --- |
| Cuadrícula 3x3 (“Select all images with …”) | 300 × 300 | `objects`: celdas que hay que pulsar |
| Cuadrícula 4x4 (“Select all squares with …”) | 450 × 450 | `objects`: celdas que hay que pulsar |
| Imagen 1x1 (la imagen individual que aparece tras pulsar en una cuadrícula 3x3) | 100 × 100 | `hasObject`: si hay que pulsar esta imagen |

Si trabajas con capturas de pantalla, distingue el tipo por el texto de la pregunta: en 3x3 dice “Select all images with …” y en 4x4 dice “Select all squares with …”.

## Ejemplo de solicitud

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

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

## Resultado

3x3 y 4x4:

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

Imagen 1x1:

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

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `objects` | array | Índices de las imágenes en las que hay que hacer clic, empezando en 0, de izquierda a derecha y de arriba abajo |
| `hasObject` | boolean | Se devuelve para una imagen de 1x1; indica si la imagen contiene el objetivo |
| `type` | string | Tipo de desafío: `multi` (imagen de 3x3 o 4x4, consulta `objects`), `single` (imagen de 1x1, consulta `hasObject`); `drag` para las preguntas de arrastre de hCaptcha |

Las celdas se numeran desde 0, de izquierda a derecha y de arriba abajo:

![Numeración de las celdas de la cuadrícula 3x3, de 0 a 8](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![Numeración de las celdas de la cuadrícula 4x4, de 0 a 15](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## confidence: obtener de una vez todas las celdas que coinciden

Después de pulsar en una cuadrícula 3x3, normalmente aparecen imágenes 1x1 nuevas que hay que seguir evaluando. Si no te resulta práctico obtener esas imágenes (por ejemplo, al desarrollar para móvil), puedes enviar `confidence`:

-   Si no lo envías, una imagen 3x3 devuelve las 3 celdas con mayor puntuación (reCAPTCHA exige pulsar al menos 3).
-   Si lo envías (se recomienda `0.5`), se devuelven todas las celdas con una puntuación superior a ese valor, que pueden ser más o menos de 3; si ninguna coincide, se devuelve un arreglo vacío. Así no tienes que capturar las imágenes 1x1.
-   No tiene efecto en imágenes 4x4 ni 1x1.

## IDs de preguntas

`question` recibe el ID de la pregunta (empieza con `/m/`), no el texto. El ID viene en la respuesta de la solicitud con la que reCAPTCHA carga el desafío (`reload` o `userverify`), junto con la imagen. La tabla siguiente muestra las preguntas más comunes; el texto en chino es solo de referencia:

16 en total

| ID de pregunta | Pregunta (inglés) |
| --- | --- |
| `/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` |

No hay preguntas que coincidan

`ERROR_UNKNOWN_QUESTION` indica que el ID es incorrecto o que esa pregunta aún no es compatible. `ERROR_UNKNOW_450x450_QUESTION` indica que esa pregunta aún no es compatible con imágenes 4x4; recarga el desafío en la página para obtener otro.

## Reporte y reembolso

Si la verificación falla tras los clics, repórtalo con [report](https://docs.yescaptcha.com/es/api/report.md) en un plazo de 1 hora; el reembolso de puntos se liquida unas 24 horas después. Las reglas están en [Facturación y reembolsos](https://docs.yescaptcha.com/es/getting-started/billing.md). Si la verificación se supera, repórtalo también con `isSuccess: true`.

## Tutoriales relacionados

-   [Clics simulados en reCAPTCHA v2 con reconocimiento de imágenes (Selenium)](https://docs.yescaptcha.com/es/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (devuelve token)](https://docs.yescaptcha.com/es/tasks/recaptcha-v2.md)