# reCAPTCHA v2 Bilderkennung

> Erkennen Sie reCAPTCHA-v2-Bildaufgaben mit YesCaptcha (ReCaptchaV2Classification): Laden Sie ein 3x3-, 4x4- oder 1x1-Bild mit der Fragen-ID hoch und erhalten Sie die anzuklickenden Felder synchron zurück; Abrechnung nach Bildgröße, Tabelle der Fragen-IDs.

Source: https://docs.yescaptcha.com/de/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` erkennt die Bildaufgaben von reCAPTCHA v2: Sie senden das Bild und die Fragen-ID und erhalten zurück, welche Felder anzuklicken sind; das Klicken im Browser übernimmt Ihr Programm. Es gibt **kein Token** zurück. Die Antwort kommt synchron, eine einzige `createTask`\-Anfrage liefert das Ergebnis. Ein 3x3- oder 4x4-Bild kostet 6 Punkte (≈ $0.90 / 1k), ein 1x1-Bild ist günstiger (siehe Tabelle).

> **Tipp:** Wenn Sie keine eigene Klicklogik schreiben möchten, nutzen Sie die [Browser-Erweiterung](https://docs.yescaptcha.com/de/extension.md). Sie klickt auf Basis dieser Schnittstelle automatisch.

- POST `https://api.yescaptcha.com/createTask` (Globaler Endpoint)
- POST `https://cn.yescaptcha.com/createTask` (China-Endpoint)

## Typen und Preise

| Aufgabentyp | Preis | Modus | Hinweise |
| --- | --- | --- | --- |
| `ReCaptchaV2Classification` | $0.90 / 1k; 6 Punkte/Aufgabe · ¥6 / 1k | Synchron | 2 Punkte für ein 1x1-Feld (100x100); 6 Punkte für 3x3 (300x300) und 4x4 (450x450) |

Die Preise in US-Dollar sind Schätzwerte bei 1 US$ ≈ ¥6.67; Aufgaben werden in Punkten berechnet.

## Anfrageparameter

| Feld | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `type` | string | Ja | Aufgabentyp; siehe „Aufgabentypen und Preise“ auf dieser Seite |
| `image` | string | Ja | Base64-kodiertes Aufgabenbild ohne das Präfix `data:` |
| `question` | string | Ja | Frage-ID, z. B. `/m/0k4j`; siehe „Frage-IDs“ auf dieser Seite |
| `confidence` | number | Nein | Konfidenzschwelle von 0 bis 1, nur für 3x3-Bilder relevant. Wenn gesetzt (0.5 ist ein guter Startwert), werden alle Felder oberhalb dieses Werts zurückgegeben; wenn nicht gesetzt, werden die 3 wahrscheinlichsten Felder zurückgegeben |

> **Achtung:** Das Bild muss auf eine der Standardgrößen in der folgenden Tabelle skaliert werden; der Server erkennt den Aufgabentyp anhand der Größe.

| Aufgabenart | Bildgröße | Rückgabe |
| --- | --- | --- |
| 3x3-Raster („Alle Bilder auswählen“) | 300 × 300 | `objects`: anzuklickende Felder |
| 4x4-Raster („Alle Felder auswählen“) | 450 × 450 | `objects`: anzuklickende Felder |
| 1x1-Bild (einzelnes Bild, das nach dem Klicken im 3x3-Raster nachgeladen wird) | 100 × 100 | `hasObject`: ob dieses Bild anzuklicken ist |

Bei Screenshots entscheidet die Fragestellung: Beim 3x3-Raster lautet sie „Alle Bilder auswählen“ (Select all images with …), beim 4x4-Raster „Alle Felder auswählen“ (Select all squares with …).

## Anfragebeispiel

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

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

## Ergebnis

3x3, 4x4:

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

1x1-Bild:

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `objects` | array | Indizes der anzuklickenden Felder, beginnend bei 0, von links nach rechts und von oben nach unten |
| `hasObject` | boolean | Wird bei einem 1x1-Einzelbild zurückgegeben; gibt an, ob das Bild das Ziel enthält |
| `type` | string | Aufgabenart: `multi` (3x3- oder 4x4-Bild, siehe `objects`), `single` (1x1-Einzelbild, siehe `hasObject`); `drag` bei hCaptcha-Ziehaufgaben |

Die Felder werden ab 0 nummeriert, von links nach rechts und von oben nach unten:

![Feldnummern 0 bis 8 des 3x3-Rasters](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![Feldnummern 0 bis 15 des 4x4-Rasters](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## confidence: alle passenden Felder auf einmal erhalten

Nach dem Klicken im 3x3-Raster erscheinen in der Regel 1x1-Bilder, die ebenfalls geprüft werden müssen. Wenn diese Bilder schwer zu erfassen sind (z. B. bei der Entwicklung für Mobilgeräte), können Sie `confidence` übergeben:

-   Ohne `confidence` liefert ein 3x3-Bild die 3 Felder mit dem höchsten Score (reCAPTCHA verlangt mindestens 3 Klicks).
-   Mit `confidence` (empfohlen: `0.5`) werden alle Felder zurückgegeben, deren Score über diesem Wert liegt; das können mehr oder weniger als 3 sein. Gibt es keine passenden Felder, ist das Array leer. So müssen Sie keine 1x1-Bilder mehr aufnehmen.
-   Bei 4x4- und 1x1-Bildern hat der Parameter keine Wirkung.

## Fragen-IDs

`question` erwartet die ID der Frage (beginnt mit `/m/`), nicht den Fragetext. Die ID steht zusammen mit dem Bild in der Antwort der Anfrage, mit der reCAPTCHA die Aufgabe lädt (`reload` oder `userverify`). Die folgende Tabelle zeigt gängige Fragen; die chinesischen Texte dienen nur als Orientierung:

Insgesamt 16

| Fragen-ID | Frage (Englisch) |
| --- | --- |
| `/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` |

Keine passenden Fragen

`ERROR_UNKNOWN_QUESTION` bedeutet, dass die ID falsch ist oder die Frage noch nicht unterstützt wird. `ERROR_UNKNOW_450x450_QUESTION` bedeutet, dass die Frage mit 4x4-Bildern noch nicht unterstützt wird; laden Sie die Aufgabe auf der Seite neu, um eine andere zu erhalten.

## Meldung und Erstattung

Wenn die Prüfung nach dem Klicken fehlschlägt, können Sie die Aufgaben innerhalb von 1 Stunde mit [report](https://docs.yescaptcha.com/de/api/report.md) melden. Die Erstattung wird nach etwa 24 Stunden abgerechnet; die Regeln finden Sie unter [Abrechnung und Punkteerstattung](https://docs.yescaptcha.com/de/getting-started/billing.md). Melden Sie auch bestandene Prüfungen mit `isSuccess: true`.

## Weiterführende Anleitungen

-   [reCAPTCHA v2 Bilderkennung: Klicks simulieren (Selenium)](https://docs.yescaptcha.com/de/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (gibt Token zurück)](https://docs.yescaptcha.com/de/tasks/recaptcha-v2.md)