# reCAPTCHA v2 이미지 인식

> YesCaptcha로 reCAPTCHA v2 이미지 문제(ReCaptchaV2Classification)를 인식해요. 3x3, 4x4, 1x1 이미지와 질문 ID를 보내면 클릭할 칸을 동기로 반환해요. 이미지 크기별로 과금하며, 질문 ID 표를 제공해요.

Source: https://docs.yescaptcha.com/ko/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 포인트 (≈ $0.90 / 1k)이고, 1x1 작은 이미지는 더 저렴해요. 아래 표를 참고하세요.

> **팁:** 클릭 로직을 직접 작성하고 싶지 않다면 [브라우저 확장 프로그램](https://docs.yescaptcha.com/ko/extension.md)을 사용하세요. 이 API를 기반으로 자동으로 클릭해요.

- POST `https://api.yescaptcha.com/createTask` (글로벌 엔드포인트)
- POST `https://cn.yescaptcha.com/createTask` (중국 엔드포인트)

## 유형과 가격

| 작업 유형 | 가격 | 반환 방식 | 설명 |
| --- | --- | --- | --- |
| `ReCaptchaV2Classification` | $0.90 / 1k; 6 포인트/작업 · ¥6 / 1k | 동기 | 1x1 타일(100x100)은 2포인트, 3x3(300x300)와 4x4(450x450)는 6포인트예요 |

미국 달러 가격은 US$1 ≈ ¥6.67 기준의 추정치이며, 작업은 포인트로 차감돼요.

## 요청 파라미터

| 필드 | 유형 | 필수 | 설명 |
| --- | --- | --- | --- |
| `type` | string | 예 | 작업 유형이에요. 이 페이지의 "작업 유형 및 가격"을 참고하세요 |
| `image` | string | 예 | 질문 이미지를 Base64로 인코딩한 값이에요. `data:` 접두사는 포함하지 마세요 |
| `question` | string | 예 | `/m/0k4j` 같은 질문 ID예요. 이 페이지의 "질문 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` 확인)이며, hCaptcha 드래그 질문은 `drag`예요 |

칸 번호는 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 이미지를 지원하지 않는다는 뜻이니, 웹 페이지에서 새로고침해 다른 문제로 바꾸면 돼요.

## 신고와 포인트 환불

클릭 후 검증에 실패했다면 1시간 이내에 [report](https://docs.yescaptcha.com/ko/api/report.md)로 신고할 수 있어요. 약 24시간 뒤에 포인트 환불이 정산되며, 규칙은 [과금과 포인트 환불](https://docs.yescaptcha.com/ko/getting-started/billing.md)에서 확인하세요. 검증을 통과한 경우에도 report로 `isSuccess: true`를 신고해 주세요.

## 관련 튜토리얼

-   [reCAPTCHA v2 이미지 인식으로 클릭 시뮬레이션 (Selenium)](https://docs.yescaptcha.com/ko/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (토큰 반환)](https://docs.yescaptcha.com/ko/tasks/recaptcha-v2.md)