Reconocimiento de imágenes de reCAPTCHA v2

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, que hace los clics automáticamente con esta misma API.

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

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

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

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

Resultado

3x3 y 4x4:

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

Imagen 1x1:

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

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

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 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. 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)
• reCAPTCHA v2 (devuelve token)