ReCaptcha Image (Grid Click)

Giải ReCaptcha dạng hình ảnh grid — gửi ảnh grid + instruction, nhận về số thứ tự các ô cần click. Phù hợp nhất cho ReCaptcha v2 Enterprise (giữ nguyên IP, User-Agent, cookies, TLS fingerprint).

Tổng quan

ReCaptcha Image là loại captcha hiển thị một lưới ảnh (3×3 hoặc 4×4) và yêu cầu click vào các ô chứa đối tượng được chỉ định (ví dụ: "Select all images with traffic lights"). Bạn gửi ảnh grid + instruction, nhận về danh sách các ô cần click.

Đánh số ô (Grid Numbering)

Ô được đánh số từ 1, đọc từ trái sang phải, trên xuống dưới.

Ví dụ: kết quả click:1,4,6 → click ô 1 (trái trên), ô 4 (trái giữa), ô 6 (phải giữa).

API v1 — in.php / res.php

1. Gửi captcha lên /in.php

Aliases:

Ví dụ Request

POST /in.php HTTP/1.1
Content-Type: application/x-www-form-urlencoded

key=point_YOUR_API_KEY&method=base64&type=gridtask&rows=3&cols=3&questions=Select+all+images+with+traffic+lights&body=/9J/4AAQSkU6RA...

Response:

2. Lấy kết quả từ /res.php

Response:

Định dạng kết quả

API v2 — createTask / getTaskResult

1. Tạo task — /v2/createTask

Ví dụ Request

{
    "clientKey": "point_YOUR_API_KEY",
    "task": {
        "type": "GridTask",
        "body": "/9J/4AAQSkU6RA...",
        "rows": 3,
        "cols": 3,
        "questions": "Select all images with traffic lights"
    }
}

Response:

2. Lấy kết quả — /v2/getTaskResult

{
    "clientKey": "point_YOUR_API_KEY",
    "taskId": "650a1f3e289ac9c3d691c5b7"
}

Response:

Có ô khớp:

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "click": [1, 4, 6]
    }
}

Không có ô nào khớp:

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "click": []
    }
}

Tại sao nên dùng GridTask cho Enterprise

ReCaptcha v2 Enterprise phân tích rủi ro dựa trên nhiều tín hiệu: IP, User-Agent, TLS fingerprint, cookies, canvas/WebGL fingerprint. Nếu dùng phương pháp token-based (gửi sitekey đến solver), solver sẽ mở trang bằng IP và fingerprint khác → Google phát hiện không khớp → token bị từ chối.

Lưu ý quan trọng

• Chỉ gửi vùng grid. Cắt ảnh chỉ chứa các ô, không bao gồm header instruction, nút Verify, hoặc UI khác.
• Luôn gửi kèm questions. Instruction text rất quan trọng cho độ chính xác. Không gửi questions sẽ giảm recognition accuracy.
• Nên chỉ định rõ rows và cols. Mặc định là 3×3, nếu grid là 4×4 thì phải chỉ định.
• Nhiều vòng captcha. Nếu sau khi click xuất hiện ô mới → gửi mỗi vòng là 1 request GridTask riêng.
• Định dạng ảnh: PNG, JPEG, BMP, GIF. Khuyến nghị PNG hoặc JPEG.

Tham khảo thêm: API v1 Docs | API v2 Docs