HCaptcha 솔버
base64로 인코딩된 이미지와 질문 프롬프트를 제공해 hCaptcha 이미지 챌린지를 해결하세요. API는 세 가지 챌린지 모드를 지원하는 PopularCaptchaImage 작업 유형을 사용합니다.
지원되는 모드
| 모드 | questionType | 설명 | 응답 |
|---|---|---|---|
| Grid / Classify | objectClassify | 그리드에서 일치하는 이미지를 모두 선택 | boolean[] — 이미지마다 하나 |
| Click | objectClick | 대상 객체의 중앙을 클릭 | {x, y}[] 좌표 |
| Drag & Drop | objectDrag | 퍼즐 조각을 올바른 위치로 드래그 | {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"
}
작업 매개변수
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string | ✅ | PopularCaptchaImage 또는 PopularClassification |
questionType | string | ✅ | objectClassify, objectClick 또는 objectDrag |
question | string | ✅ | 챌린지 지시 텍스트 |
queries | string[] | ✅ | base64로 인코딩된 이미지(그리드 타일 또는 메인 이미지) |
examples | string[] | Drag 전용 | 드래그 작업의 대상 객체 |
screenshort | boolean | 아니요 | 이미지가 스크린샷이면 true로 설정 |