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

> Распознавание картиночных заданий reCAPTCHA v2 через YesCaptcha (ReCaptchaV2Classification): отправьте изображение 3x3, 4x4 или 1x1 и ID вопроса — синхронно получите ячейки, на которые нужно нажать; цена зависит от размера изображения; таблица ID вопросов.

Source: https://docs.yescaptcha.com/ru/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` распознаёт картиночные задания reCAPTCHA v2: вы отправляете изображение и ID вопроса, в ответ получаете ячейки, на которые нужно нажать, а сами клики выполняет ваша программа в браузере. Токен он **не возвращает**. Ответ синхронный: результат приходит в одном запросе `createTask`. Изображение 3x3 или 4x4 стоит 6 pts (≈ $0.90 / 1k), маленькое изображение 1x1 дешевле (см. таблицу ниже).

> **Совет:** Если не хотите писать логику кликов, используйте [расширение браузера](https://docs.yescaptcha.com/ru/extension.md) — оно автоматически кликает на основе этого же интерфейса.

- POST `https://api.yescaptcha.com/createTask` (Глобальный endpoint)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint для Китая)

## Типы и цены

| Тип задачи | Цена | Режим | Примечания |
| --- | --- | --- | --- |
| `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

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

## Результат

3x3 и 4x4:

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

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

```json
{
  "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, слева направо и сверху вниз:

![Номера ячеек сетки 3x3 от 0 до 8](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![Номера ячеек сетки 4x4 от 0 до 15](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## 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](https://docs.yescaptcha.com/ru/api/report.md) в течение 1 часа; возврат баллов после жалобы рассчитывается примерно через 24 часа, правила — в разделе [Тарификация и возврат баллов](https://docs.yescaptcha.com/ru/getting-started/billing.md). Если проверка пройдена, тоже сообщите об этом через report с `isSuccess: true`.

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

-   [Имитация кликов для распознавания изображений reCAPTCHA v2 (Selenium)](https://docs.yescaptcha.com/ru/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (возвращает токен)](https://docs.yescaptcha.com/ru/tasks/recaptcha-v2.md)