reCAPTCHA v2 Bilderkennung

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. Sie klickt auf Basis dieser Schnittstelle automatisch.

POSThttps://api.yescaptcha.com/createTaskGlobaler EndpointKopieren

POSThttps://cn.yescaptcha.com/createTaskChina-EndpointKopieren

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

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

Ergebnis

3x3, 4x4:

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

1x1-Bild:

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

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

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 melden. Die Erstattung wird nach etwa 24 Stunden abgerechnet; die Regeln finden Sie unter Abrechnung und Punkteerstattung. Melden Sie auch bestandene Prüfungen mit isSuccess: true.

Weiterführende Anleitungen

• reCAPTCHA v2 Bilderkennung: Klicks simulieren (Selenium)
• reCAPTCHA v2 (gibt Token zurück)