การจดจำภาพ reCAPTCHA v2

ReCaptchaV2Classification ใช้จดจำโจทย์ภาพที่ reCAPTCHA v2 แสดงขึ้นมา โดยส่งภาพและ ID ของคำถามเข้าไป แล้วจะได้ช่องที่ควรคลิกกลับมา จากนั้นโปรแกรมของคุณจะเป็นฝ่ายคลิกในเบราว์เซอร์เอง ประเภทนี้ไม่คืนค่า token และทำงานแบบซิงโครนัส คือได้ผลลัพธ์จากคำขอ createTask เพียงครั้งเดียว ภาพ 3x3 และ 4x4 คิดภาพละ 6 พอยต์ (≈ $0.90 / 1k) ส่วนภาพเล็ก 1x1 ราคาถูกกว่า ดูได้จากตารางด้านล่าง

เคล็ดลับ

หากไม่ต้องการเขียนโค้ดคลิกเอง ใช้ ส่วนขยายเบราว์เซอร์ ได้เลย ซึ่งคลิกให้อัตโนมัติโดยอาศัย API นี้

POSThttps://api.yescaptcha.com/createTaskendpoint ทั่วโลกคัดลอก

POSThttps://cn.yescaptcha.com/createTaskendpoint จีนคัดลอก

ประเภทงานและราคา

ประเภทงาน	ราคา	รูปแบบการคืนผลลัพธ์	หมายเหตุ
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	ใช่	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

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

ผลลัพธ์

3x3 และ 4x4:

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

ภาพเล็ก 1x1:

{
  "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 เรียงจากซ้ายไปขวา และจากบนลงล่าง:

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 ภายใน 1 ชั่วโมง และจะคืนพอยต์หลังรายงานเมื่อผ่านไปประมาณ 24 ชั่วโมง ดูกฎได้ที่ การคิดเงินและการคืนพอยต์ หากยืนยันผ่านก็ขอให้รายงานด้วย report โดยส่ง isSuccess: true เช่นกัน

บทความที่เกี่ยวข้อง

• การจำลองการคลิกภาพ reCAPTCHA v2 (Selenium)
• reCAPTCHA v2 (คืนค่า token)