# Pengenalan gambar reCAPTCHA v2

> Kenali tantangan gambar reCAPTCHA v2 dengan YesCaptcha (ReCaptchaV2Classification): unggah gambar 3x3, 4x4, atau 1x1 beserta ID pertanyaan, dan dapatkan kotak yang harus diklik secara sinkron; harga sesuai ukuran gambar; tabel ID pertanyaan.

Source: https://docs.yescaptcha.com/id/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` 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](https://docs.yescaptcha.com/id/extension.md), yang mengeklik otomatis berdasarkan API ini.

- POST `https://api.yescaptcha.com/createTask` (Endpoint global)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint Tiongkok)

## 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

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

## Hasil

3x3 dan 4x4:

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

Gambar kecil 1x1:

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

![Nomor kotak 0 sampai 8 pada kisi 3x3](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![Nomor kotak 0 sampai 15 pada kisi 4x4](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## 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` |

Tidak ada pertanyaan yang cocok

`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](https://docs.yescaptcha.com/id/api/report.md) dalam 1 jam; pengembalian poin setelah laporan diselesaikan sekitar 24 jam kemudian. Aturannya ada di [Penagihan dan pengembalian poin](https://docs.yescaptcha.com/id/getting-started/billing.md). Jika verifikasi berhasil, laporkan juga dengan `isSuccess: true`.

## Panduan terkait

-   [Klik gambar reCAPTCHA v2 dengan Selenium](https://docs.yescaptcha.com/id/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (mengembalikan token)](https://docs.yescaptcha.com/id/tasks/recaptcha-v2.md)