Skip to content
CaptchaSonic

Bộ giải HCaptcha

Giải thử thách hình ảnh hCaptcha bằng cách cung cấp các ảnh mã hóa base64 và nội dung câu hỏi. API dùng loại tác vụ PopularCaptchaImage, hỗ trợ ba chế độ thử thách.

Các chế độ được hỗ trợ

Chế độquestionTypeMô tảPhản hồi
Lưới / Phân loạiobjectClassifyChọn tất cả ảnh khớp trong lướiboolean[] — một giá trị cho mỗi ảnh
NhấpobjectClickNhấp vào tâm của đối tượng cần tìmTọa độ {x, y}[]
Kéo & thảobjectDragKéo mảnh ghép đến đúng vị tríTọa độ {start, end}[]

Tạo tác vụ — Lưới / Phân loại

Chế độ phổ biến nhất. Gửi các ô ảnh mã hóa base64 và nội dung câu hỏi.

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

Phản hồi

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

Mỗi answers[i] tương ứng với queries[i] — true nghĩa là ảnh khớp với câu hỏi.

Tạo tác vụ — Nhấp

Gửi một ảnh. Bộ giải trả về tọa độ của đối tượng cần tìm.

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

Phản hồi

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

Tạo tác vụ — Kéo & thả

Gửi ảnh nền trong queries và mảnh ghép trong 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"]
    }
}

Phản hồi

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

Tham số tác vụ

Thuộc tínhKiểuBắt buộcMô tả
typestring✅PopularCaptchaImage hoặc PopularClassification
questionTypestring✅objectClassify, objectClick hoặc objectDrag
questionstring✅Nội dung hướng dẫn thử thách
queriesstring[]✅Ảnh mã hóa base64 (các ô lưới hoặc ảnh chính)
examplesstring[]Chỉ với kéoĐối tượng đích cho tác vụ kéo
screenshortbooleanKhôngĐặt true nếu ảnh là ảnh chụp màn hình

Sân chơi API

POST
Đăng nhập để tự động điền API key của bạn
Payload
Phản hồi

Nhấn Gửi để xem phản hồi

⌘ + Enter

Tham số

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

Mã lỗi

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
Mã
terminal