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

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, tiện ích này dựa trên chính API này và tự động nhấp.

POSThttps://api.yescaptcha.com/createTaskEndpoint quốc tếSao chép

POSThttps://cn.yescaptcha.com/createTaskEndpoint Trung QuốcSao chép

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

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

Kết quả trả về

3x3, 4x4:

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

Ảnh nhỏ 1x1:

{
  "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:

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

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 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. 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)
• reCAPTCHA v2 (trả về token)