Skip to content
CaptchaSonic

HCaptcha 솔버

base64로 인코딩된 이미지와 질문 프롬프트를 제공해 hCaptcha 이미지 챌린지를 해결하세요. API는 세 가지 챌린지 모드를 지원하는 PopularCaptchaImage 작업 유형을 사용합니다.

지원되는 모드

모드questionType설명응답
Grid / ClassifyobjectClassify그리드에서 일치하는 이미지를 모두 선택boolean[] — 이미지마다 하나
ClickobjectClick대상 객체의 중앙을 클릭{x, y}[] 좌표
Drag & DropobjectDrag퍼즐 조각을 올바른 위치로 드래그{start, end}[] 좌표

작업 생성 — Grid / Classify

가장 흔한 모드입니다. base64로 인코딩된 이미지 타일과 질문 텍스트를 보내세요.

POST/createTask
호스트api.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", "..."]
    }
}

응답

{
    "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는 이미지가 질문과 일치한다는 뜻입니다.

작업 생성 — Click

이미지 한 장을 보내세요. solver가 대상 객체의 좌표를 반환합니다.

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

응답

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

작업 생성 — Drag & Drop

배경 이미지는 queries에, 퍼즐 조각은 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"]
    }
}

응답

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

작업 매개변수

속성타입필수설명
typestring✅PopularCaptchaImage 또는 PopularClassification
questionTypestring✅objectClassify, objectClick 또는 objectDrag
questionstring✅챌린지 지시 텍스트
queriesstring[]✅base64로 인코딩된 이미지(그리드 타일 또는 메인 이미지)
examplesstring[]Drag 전용드래그 작업의 대상 객체
screenshortboolean아니요이미지가 스크린샷이면 true로 설정

API 플레이그라운드

POST
로그인 하면 API 키가 자동으로 입력됩니다
페이로드
응답

보내기를 눌러 응답을 확인하세요

⌘ + 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