Распознавание изображений reCAPTCHA v2

ReCaptchaV2Classification распознаёт картиночные задания reCAPTCHA v2: вы отправляете изображение и ID вопроса, в ответ получаете ячейки, на которые нужно нажать, а сами клики выполняет ваша программа в браузере. Токен он не возвращает. Ответ синхронный: результат приходит в одном запросе createTask. Изображение 3x3 или 4x4 стоит 6 pts (≈ $0.90 / 1k), маленькое изображение 1x1 дешевле (см. таблицу ниже).

Совет

Если не хотите писать логику кликов, используйте расширение браузера — оно автоматически кликает на основе этого же интерфейса.

POSThttps://api.yescaptcha.com/createTaskГлобальный endpointКопировать

POSThttps://cn.yescaptcha.com/createTaskEndpoint для КитаяКопировать

Типы и цены

Тип задачи	Цена	Режим	Примечания
ReCaptchaV2Classification	$0.90 / 1k; 6 pts/задача · ¥6 / 1k	Синхронный	2 балла за плитку 1x1 (100x100); 6 баллов за 3x3 (300x300) и 4x4 (450x450)

Цены в долларах США являются оценочными и рассчитаны по курсу 1 USD ≈ ¥6.67; списание за задачи производится в баллах.

Параметры запроса

Поле	Тип	Обязательное	Описание
type	string	Да	Тип задачи; см. «Типы задач и цены» на этой странице
image	string	Да	Изображение задания в кодировке Base64 без префикса data:
question	string	Да	ID вопроса, например /m/0k4j; см. «ID вопросов» на этой странице
confidence	number	Нет	Порог уверенности от 0 до 1, используется только для изображений 3x3. Если задан (для начала подойдёт 0.5), возвращаются все ячейки выше этого порога; если не задан, возвращаются 3 наиболее вероятные ячейки

Осторожно

Изображение нужно привести к одному из стандартных размеров из таблицы ниже: сервер определяет тип задания по размеру.

Тип задания	Размер изображения	Что возвращается
Сетка 3x3 («Выберите все изображения»)	300 × 300	objects: ячейки, на которые нужно нажать
Сетка 4x4 («Выберите все квадраты»)	450 × 450	objects: ячейки, на которые нужно нажать
Маленькое изображение 1x1 (отдельная картинка, появляющаяся после клика в сетке 3x3)	100 × 100	hasObject: нужно ли нажимать на это изображение

Если у вас скриншот, определите тип по тексту вопроса: у 3x3 это «Выберите все изображения» (Select all images with …), у 4x4 — «Выберите все квадраты» (Select all squares with …).

Пример запроса

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

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

Результат

3x3 и 4x4:

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

Маленькое изображение 1x1:

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

Поле	Тип	Описание
objects	array	Индексы ячеек, по которым нужно кликнуть, начиная с 0, слева направо и сверху вниз
hasObject	boolean	Возвращается для фрагмента 1x1: есть ли на нём целевой объект
type	string	Тип задания: multi (изображение 3x3 или 4x4, смотрите objects), single (фрагмент 1x1, смотрите hasObject); drag для заданий hCaptcha с перетаскиванием

Ячейки нумеруются с 0, слева направо и сверху вниз:

confidence: получить все подходящие ячейки за один раз

После клика в сетке 3x3 обычно появляются маленькие изображения 1x1, которые тоже нужно проверить. Если получить их неудобно (например, при разработке для мобильных устройств), передайте confidence:

• Без него для изображения 3x3 возвращаются 3 ячейки с наивысшей оценкой (reCAPTCHA требует нажать минимум 3).
• С ним (рекомендуем 0.5) возвращаются все ячейки с оценкой выше этого значения — их может быть больше или меньше 3; если подходящих нет, возвращается пустой массив. Так не нужно снимать скриншоты изображений 1x1.
• Для изображений 4x4 и 1x1 параметр не действует.

ID вопросов

В question указывается ID вопроса (начинается с /m/), а не текст вопроса. ID приходит вместе с изображением в ответе на запрос, которым reCAPTCHA загружает задание (reload или userverify). Ниже — распространённые вопросы; китайский текст приведён только для справки:

Всего: 16

ID вопроса	Вопрос (английский)
/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 означает, что ID указан неверно или этот вопрос пока не поддерживается. ERROR_UNKNOW_450x450_QUESTION означает, что этот вопрос пока не поддерживается для изображений 4x4 — обновите задание на странице, чтобы получить другое.

Жалобы и возврат баллов

Если проверка после кликов не пройдена, сообщите об этом через report в течение 1 часа; возврат баллов после жалобы рассчитывается примерно через 24 часа, правила — в разделе Тарификация и возврат баллов. Если проверка пройдена, тоже сообщите об этом через report с isSuccess: true.

Связанные руководства

• Имитация кликов для распознавания изображений reCAPTCHA v2 (Selenium)
• reCAPTCHA v2 (возвращает токен)