Pengenalan gambar reCAPTCHA v2

ReCaptchaV2Classification mengenali tantangan gambar yang muncul pada reCAPTCHA v2: kirim gambar dan ID pertanyaan, lalu Anda mendapat kotak mana yang harus diklik; program Anda yang melakukan klik di browser. Jenis ini tidak mengembalikan token. Hasilnya sinkron, cukup satu permintaan createTask; gambar 3x3 atau 4x4 dikenai 6 poin (≈ $0.90 / 1k) per gambar, sedangkan gambar kecil 1x1 lebih murah, lihat tabel di bawah.

Tips

Jika tidak ingin menulis logika klik sendiri, gunakan ekstensi browser, yang mengeklik otomatis berdasarkan API ini.

POSThttps://api.yescaptcha.com/createTaskEndpoint globalSalin

POSThttps://cn.yescaptcha.com/createTaskEndpoint TiongkokSalin

Jenis tugas dan harga

Jenis tugas	Harga	Mode	Catatan
ReCaptchaV2Classification	$0.90 / 1k; 6 poin/tugas · ¥6 / 1k	Sinkron	2 poin untuk petak 1x1 (100x100); 6 poin untuk 3x3 (300x300) dan 4x4 (450x450)

Harga dalam dolar AS adalah perkiraan dengan kurs US$1 ≈ ¥6.67; tugas ditagih dalam poin.

Parameter permintaan

Kolom	Tipe	Wajib	Deskripsi
type	string	Ya	Jenis tugas; lihat "Jenis tugas dan harga" di halaman ini
image	string	Ya	Gambar soal yang dienkode Base64 tanpa prefiks data:
question	string	Ya	ID pertanyaan seperti /m/0k4j; lihat "ID pertanyaan" di halaman ini
confidence	number	Tidak	Ambang kepercayaan dari 0 sampai 1, hanya berlaku untuk gambar 3x3. Jika diisi (disarankan mulai dari 0.5), semua kotak di atas nilai tersebut dikembalikan; jika tidak diisi, 3 kotak teratas yang dikembalikan

Perhatian

Gambar harus diubah ukurannya ke salah satu ukuran standar pada tabel di bawah; server menentukan jenis tantangan berdasarkan ukuran.

Jenis tantangan	Ukuran gambar	Hasil
Kisi 3x3 (“Select all images with …”)	300 × 300	objects: kotak yang harus diklik
Kisi 4x4 (“Select all squares with …”)	450 × 450	objects: kotak yang harus diklik
Gambar kecil 1x1 (satu gambar pengganti yang muncul setelah klik pada kisi 3x3)	100 × 100	hasObject: apakah gambar ini perlu diklik

Jika Anda menggunakan tangkapan layar, bedakan dari pertanyaannya: kisi 3x3 berbunyi “Select all images with …”, sedangkan kisi 4x4 berbunyi “Select all squares with …”.

Contoh permintaan

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

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

Hasil

3x3 dan 4x4:

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

Gambar kecil 1x1:

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

Kolom	Tipe	Deskripsi
objects	array	Indeks gambar yang harus diklik, dimulai dari 0, dari kiri ke kanan dan atas ke bawah
hasObject	boolean	Dikembalikan untuk gambar kecil 1x1; apakah gambar tersebut berisi target
type	string	Jenis soal: multi (gambar besar 3x3 atau 4x4, lihat objects), single (gambar kecil 1x1, lihat hasObject); drag untuk soal geser hCaptcha

Kotak diberi nomor mulai dari 0, dari kiri ke kanan dan dari atas ke bawah:

confidence: dapatkan semua kotak yang cocok sekaligus

Setelah kisi 3x3 diklik, biasanya muncul gambar kecil 1x1 yang juga perlu diperiksa. Jika gambar kecil itu sulit diambil (misalnya saat mengembangkan untuk ponsel), kirim confidence:

• Jika tidak dikirim, gambar 3x3 mengembalikan 3 kotak dengan skor tertinggi (reCAPTCHA mewajibkan minimal 3 klik).
• Jika dikirim (disarankan 0.5), semua kotak dengan skor di atas nilai tersebut dikembalikan, jumlahnya bisa lebih atau kurang dari 3; jika tidak ada yang cocok, hasilnya array kosong. Dengan begitu Anda tidak perlu lagi mengirim gambar kecil 1x1.
• Tidak berpengaruh pada gambar 4x4 dan 1x1.

ID pertanyaan

question diisi dengan ID pertanyaan (diawali /m/), bukan teks pertanyaannya. ID ini dikirim bersama gambar dalam respons permintaan yang dipakai reCAPTCHA untuk memuat tantangan (reload atau userverify). Berikut pertanyaan yang umum; terjemahan Mandarin hanya sebagai referensi:

Total 16

ID pertanyaan	Pertanyaan (Inggris)
/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 berarti ID salah atau pertanyaan ini belum didukung; ERROR_UNKNOW_450x450_QUESTION berarti pertanyaan ini belum didukung untuk gambar 4x4, cukup muat ulang di halaman untuk mendapat pertanyaan lain.

Laporan dan pengembalian poin

Jika verifikasi gagal setelah klik, laporkan dengan report dalam 1 jam; pengembalian poin setelah laporan diselesaikan sekitar 24 jam kemudian. Aturannya ada di Penagihan dan pengembalian poin. Jika verifikasi berhasil, laporkan juga dengan isSuccess: true.

Panduan terkait

• Klik gambar reCAPTCHA v2 dengan Selenium
• reCAPTCHA v2 (mengembalikan token)