Skip to content

Решатель hCaptcha

Решайте задачи hCaptcha, отправляя изображения в base64 и текст задания. API использует тип задачи PopularCaptchaImage с тремя режимами.

Поддерживаемые режимы

РежимquestionTypeОписаниеОтвет
Сетка / КлассификацияobjectClassifyВыбрать все подходящие изображения в сеткеboolean[] — по одному на изображение
КликobjectClickКликнуть по центру целевого объектаКоординаты {x, y}[]
Drag & DropobjectDragПеретащить фрагменты паззла на нужные местаКоординаты {start, end}[]

Создание задачи — Сетка / Классификация

Самый распространённый режим. Отправьте изображения сетки в base64 и текст задания.

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

Ответ

{
    "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 означает совпадение с заданием.

Создание задачи — Клик

Отправьте одно изображение. Решатель вернёт координаты целевого объекта.

{
    "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"
}

Параметры задачи

ПараметрТипОбязательныйОписание
typestringPopularCaptchaImage или PopularClassification
questionTypestringobjectClassify, objectClick или objectDrag
questionstringТекст инструкции задачи
queriesstring[]Изображения в base64 (сетка или основное изображение)
examplesstring[]Только dragЦелевые объекты для drag-задач
screenshortbooleanНетtrue, если переданы скриншоты

API Playground

POST
Log in to auto-fill your API key
Payload
Response

Hit Send to see response

⌘ + Enter

Parameters

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

Error Codes

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