Skip to content
CaptchaSonic

HCaptcha Solver

base64-encoded images और question prompt देकर hCaptcha image challenges हल करें। API PopularCaptchaImage task type का उपयोग करता है, जो तीन challenge modes समर्थित करता है।

समर्थित Modes

ModequestionTypeDescriptionResponse
Grid / ClassifyobjectClassifygrid से सभी मेल खाने वाली images चुनेंboolean[] — प्रति image एक
ClickobjectClickलक्ष्य वस्तु के केंद्र पर क्लिक करें{x, y}[] निर्देशांक
Drag & DropobjectDragpuzzle pieces को सही स्थान पर खींचें{start, end}[] निर्देशांक

Create Task — Grid / Classify

सबसे आम mode। base64-encoded image tiles और question text भेजें।

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", "..."]
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [true, false, true, true, false, true, true, true, true],
    "questionType": "objectClassify",
    "meta": { "pass_report": true, "fail_report": true }
}

प्रत्येक answers[i], queries[i] से मेल खाता है — true का अर्थ है कि image प्रश्न से मेल खाती है।

Create Task — Click

एक single image भेजें। solver लक्ष्य वस्तु के निर्देशांक लौटाता है।

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "PopularCaptchaImage",
        "questionType": "objectClick",
        "question": "Click on the center of the cat",
        "queries": ["BASE64_MAIN_IMAGE"]
    }
}

Response

{
    "code": 200,
    "answers": [[{ "x": 142, "y": 205 }]],
    "questionType": "objectClick"
}

Create Task — Drag & Drop

queries में background image और examples में puzzle piece भेजें।

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "PopularCaptchaImage",
        "questionType": "objectDrag",
        "question": "Drag the puzzle piece to the gap",
        "queries": ["BASE64_BACKGROUND"],
        "examples": ["BASE64_PUZZLE_PIECE"]
    }
}

Response

{
    "code": 200,
    "answers": [[{ "start": [100, 200], "end": [150, 250] }]],
    "questionType": "objectDrag"
}

Task Parameters

PropertyTypeRequiredDescription
typestring✅PopularCaptchaImage या PopularClassification
questionTypestring✅objectClassify, objectClick, या objectDrag
questionstring✅challenge निर्देश text
queriesstring[]✅Base64-encoded images (grid tiles या main image)
examplesstring[]केवल Dragdrag tasks के लिए लक्ष्य वस्तुएँ
screenshortbooleanNoयदि images screenshots हैं तो true सेट करें

API Playground

POST
लॉग इन करें अपनी API key अपने-आप भरने के लिए
Payload
रिस्पॉन्स

रिस्पॉन्स देखने के लिए भेजें दबाएँ

⌘ + Enter

पैरामीटर

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

त्रुटि कोड

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
कोड
terminal