# Nhận dạng hình ảnh reCAPTCHA v2

> Dùng YesCaptcha để nhận dạng câu hỏi hình ảnh của reCAPTCHA v2 (ReCaptchaV2Classification): tải lên ảnh 3x3, 4x4 hoặc 1x1 cùng ID câu hỏi, nhận về ngay (đồng bộ) các ô cần nhấp; tính phí theo kích thước ảnh, kèm bảng ID câu hỏi.

Source: https://docs.yescaptcha.com/vi/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` nhận dạng câu hỏi hình ảnh mà reCAPTCHA v2 hiển thị: bạn gửi ảnh và ID câu hỏi, API trả về các ô cần nhấp, chương trình của bạn sẽ nhấp trong trình duyệt. Loại này **không trả về token**. Kết quả trả về đồng bộ, chỉ cần một yêu cầu `createTask`; mỗi ảnh 3x3 hoặc 4x4 là 6 điểm (≈ $0.90 / 1k), ảnh nhỏ 1x1 rẻ hơn, xem bảng bên dưới.

> **Mẹo:** Nếu không muốn tự viết logic nhấp chuột, bạn có thể dùng [tiện ích trình duyệt](https://docs.yescaptcha.com/vi/extension.md), tiện ích này dựa trên chính API này và tự động nhấp.

- POST `https://api.yescaptcha.com/createTask` (Endpoint quốc tế)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint Trung Quốc)

## Loại tác vụ và giá

| Loại tác vụ | Giá | Cách trả kết quả | Ghi chú |
| --- | --- | --- | --- |
| `ReCaptchaV2Classification` | $0.90 / 1k; 6 điểm/tác vụ · ¥6 / 1k | Đồng bộ | 2 điểm cho ô ảnh 1x1 (100x100); 6 điểm cho 3x3 (300x300) và 4x4 (450x450) |

Giá bằng đô la Mỹ chỉ là ước tính theo US$1 ≈ ¥6.67; tác vụ được trừ điểm.

## Tham số yêu cầu

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `type` | string | Có | Loại tác vụ; xem "Loại tác vụ và giá" trên trang này |
| `image` | string | Có | Ảnh câu hỏi mã hóa Base64, không có tiền tố `data:` |
| `question` | string | Có | ID câu hỏi, ví dụ `/m/0k4j`; xem "ID câu hỏi" trên trang này |
| `confidence` | number | Không | Ngưỡng độ tin cậy từ 0 đến 1, chỉ dùng cho ảnh 3x3. Nếu đặt (nên bắt đầu với 0.5), mọi ô có độ tin cậy cao hơn ngưỡng sẽ được trả về; nếu bỏ qua, 3 ô có khả năng cao nhất sẽ được trả về |

> **Chú ý:** Ảnh phải được thu phóng về đúng một trong các kích thước chuẩn trong bảng dưới; máy chủ dựa vào kích thước để xác định loại câu hỏi.

| Loại câu hỏi | Kích thước ảnh | Kết quả trả về |
| --- | --- | --- |
| Lưới 3x3 (“Select all images with …”) | 300 × 300 | `objects`: các ô cần nhấp |
| Lưới 4x4 (“Select all squares with …”) | 450 × 450 | `objects`: các ô cần nhấp |
| Ảnh nhỏ 1x1 (ảnh đơn xuất hiện sau khi nhấp ở lưới 3x3) | 100 × 100 | `hasObject`: ảnh này có cần nhấp hay không |

Nếu dùng ảnh chụp màn hình, hãy phân biệt qua nội dung câu hỏi: câu hỏi 3x3 là “Select all images with …”, câu hỏi 4x4 là “Select all squares with …”.

## Ví dụ yêu cầu

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

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

## Kết quả trả về

3x3, 4x4:

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

Ảnh nhỏ 1x1:

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

| Trường | Kiểu | Mô tả |
| --- | --- | --- |
| `objects` | array | Chỉ số của các ô cần nhấp, bắt đầu từ 0, từ trái sang phải và từ trên xuống dưới |
| `hasObject` | boolean | Được trả về với ảnh nhỏ 1x1; cho biết ảnh có chứa mục tiêu hay không |
| `type` | string | Loại câu hỏi: `multi` (ảnh lớn 3x3 hoặc 4x4, xem `objects`), `single` (ảnh nhỏ 1x1, xem `hasObject`); `drag` với câu hỏi kéo thả của hCaptcha |

Các ô được đánh số từ 0, từ trái sang phải, từ trên xuống dưới:

![Số thứ tự các ô từ 0 đến 8 của lưới 3x3](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![Số thứ tự các ô từ 0 đến 15 của lưới 4x4](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## confidence: trả về một lần tất cả các ô phù hợp

Sau khi nhấp xong câu hỏi 3x3, thường sẽ xuất hiện các ảnh nhỏ 1x1 mới cần tiếp tục kiểm tra. Nếu khó lấy các ảnh nhỏ này (ví dụ khi phát triển trên di động), bạn có thể truyền `confidence`:

-   Không truyền: với ảnh 3x3, trả về 3 ô có điểm cao nhất (reCAPTCHA yêu cầu nhấp ít nhất 3 ô).
-   Có truyền (nên dùng `0.5`): trả về tất cả các ô có điểm cao hơn giá trị này, có thể nhiều hơn hoặc ít hơn 3 ô; nếu không có ô nào phù hợp thì trả về mảng rỗng. Như vậy bạn không cần chụp thêm ảnh nhỏ 1x1.
-   Không có tác dụng với ảnh 4x4 và 1x1.

## ID câu hỏi

`question` điền ID của câu hỏi (bắt đầu bằng `/m/`), không phải nội dung chữ của câu hỏi. ID nằm trong phản hồi của yêu cầu mà reCAPTCHA dùng để tải câu hỏi (`reload` hoặc `userverify`), được gửi cùng với ảnh. Bảng dưới là các câu hỏi thường gặp, phần tiếng Trung chỉ để tham khảo:

Tổng cộng 16

| ID câu hỏi | Câu hỏi (tiếng Anh) |
| --- | --- |
| `/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` |

Không có câu hỏi phù hợp

Nếu trả về `ERROR_UNKNOWN_QUESTION` nghĩa là ID bị điền sai hoặc câu hỏi này chưa được hỗ trợ; `ERROR_UNKNOW_450x450_QUESTION` nghĩa là câu hỏi này chưa hỗ trợ ảnh 4x4, chỉ cần làm mới trên trang web để đổi câu hỏi khác.

## Báo cáo và hoàn điểm

Nếu nhấp xong mà xác minh thất bại, bạn có thể báo cáo bằng [report](https://docs.yescaptcha.com/vi/api/report.md) trong vòng 1 giờ; khoảng 24 giờ sau sẽ quyết toán hoàn điểm, xem quy tắc tại [Tính phí và hoàn điểm](https://docs.yescaptcha.com/vi/getting-started/billing.md). Trường hợp xác minh thành công cũng nên dùng report để báo cáo `isSuccess: true`.

## Hướng dẫn liên quan

-   [Mô phỏng nhấp chuột nhận dạng hình ảnh reCAPTCHA v2 (Selenium)](https://docs.yescaptcha.com/vi/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (trả về token)](https://docs.yescaptcha.com/vi/tasks/recaptcha-v2.md)