Skip to content
CaptchaSonic

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

ModusquestionTypeBeschreibungAntwort
Raster / KlassifizierenobjectClassifyAlle passenden Bilder aus einem Raster auswählenboolean[] — einer pro Bild
KlickobjectClickIn die Mitte eines Zielobjekts klicken{x, y}[]-Koordinaten
Drag & DropobjectDragPuzzleteile 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/createTask
Hostapi.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] entspricht queries[i] — true bedeutet, 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

EigenschaftTypPflichtBeschreibung
typestring✅PopularCaptchaImage oder PopularClassification
questionTypestring✅objectClassify, objectClick oder objectDrag
questionstring✅Der Text der Challenge-Anweisung
queriesstring[]✅Base64-kodierte Bilder (Kacheln oder Hauptbild)
examplesstring[]Nur DragZielobjekte für Drag-Aufgaben
screenshortbooleanNeinAuf 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

apiKeystringYOUR_API_KEY
taskobject{...}
└ typestringPopularCaptchaImage
└ questionTypestringobjectClassify
└ questionstringSelect all images with a bus
└ queriesarray[2 items]

Fehlercodes

1KEY_DOES_NOT_EXIST
2NO_SLOT_AVAILABLE
3ZERO_BALANCE
10ERROR_BAD_PARAMETERS
12ERROR_CAPTCHA_UNSOLVABLE
14PLAN_EXPIRED
16RATE_LIMITED
17DAILY_LIMIT_EXCEEDED
18QUOTA_LIMIT_EXCEEDED
21SERVICE_UNAVAILABLE
Code
terminal