HCaptcha-Solver
Lösen Sie hCaptcha-Bild-Challenges, indem Sie Base64-kodierte Bilder und den Fragetext übergeben. Die API nutzt den Aufgabentyp PopularCaptchaImage, der drei Challenge-Modi unterstützt.
Unterstützte Modi
| Modus | questionType | Beschreibung | Antwort |
|---|---|---|---|
| Raster / Klassifizieren | objectClassify | Alle passenden Bilder aus einem Raster auswählen | boolean[] — einer pro Bild |
| Klick | objectClick | In die Mitte eines Zielobjekts klicken | {x, y}[]-Koordinaten |
| Drag & Drop | objectDrag | Puzzleteile an die richtige Position ziehen | {start, end}[]-Koordinaten |
Aufgabe erstellen — Raster / Klassifizieren
Der häufigste Modus. Senden Sie Base64-kodierte Kachelbilder und den Fragetext.
POST
/createTaskHostapi.captchasonic.com
Content-Typeapplication/json
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClassify",
"question": "Select all images with a bus",
"queries": ["BASE64_IMG_1", "BASE64_IMG_2", "..."]
}
}
Antwort
{
"code": 200,
"msg": "",
"answers": [true, false, true, true, false, true, true, true, true],
"questionType": "objectClassify",
"meta": { "pass_report": true, "fail_report": true }
}
Jedes
answers[i]entsprichtqueries[i]—truebedeutet, dass das Bild zur Frage passt.
Aufgabe erstellen — Klick
Senden Sie ein einzelnes Bild. Der Solver liefert die Koordinaten des Zielobjekts.
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClick",
"question": "Click on the center of the cat",
"queries": ["BASE64_MAIN_IMAGE"]
}
}
Antwort
{
"code": 200,
"answers": [[{ "x": 142, "y": 205 }]],
"questionType": "objectClick"
}
Aufgabe erstellen — Drag & Drop
Senden Sie das Hintergrundbild in queries und das Puzzleteil in examples.
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectDrag",
"question": "Drag the puzzle piece to the gap",
"queries": ["BASE64_BACKGROUND"],
"examples": ["BASE64_PUZZLE_PIECE"]
}
}
Antwort
{
"code": 200,
"answers": [[{ "start": [100, 200], "end": [150, 250] }]],
"questionType": "objectDrag"
}
Aufgabenparameter
| Eigenschaft | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | string | ✅ | PopularCaptchaImage oder PopularClassification |
questionType | string | ✅ | objectClassify, objectClick oder objectDrag |
question | string | ✅ | Der Text der Challenge-Anweisung |
queries | string[] | ✅ | Base64-kodierte Bilder (Kacheln oder Hauptbild) |
examples | string[] | Nur Drag | Zielobjekte für Drag-Aufgaben |
screenshort | boolean | Nein | Auf true setzen, wenn es sich um Screenshots handelt |
API-Playground
POST
Anmelden um Ihren API-Schlüssel automatisch auszufüllen
Payload
Antwort
Senden drücken, um die Antwort zu sehen
⌘ + Enter
Parameter
Fehlercodes
terminal