Skip to content
CaptchaSonic

Solver HCaptcha

Selesaikan tantangan gambar hCaptcha dengan memberikan gambar ter-encode base64 dan teks perintah. API menggunakan tipe task PopularCaptchaImage, yang mendukung tiga mode tantangan.

Mode yang Didukung

ModequestionTypeDeskripsiRespons
Grid / ClassifyobjectClassifyPilih semua gambar yang cocok dari gridboolean[] — satu per gambar
ClickobjectClickKlik di tengah objek targetKoordinat {x, y}[]
Drag & DropobjectDragSeret potongan puzzle ke posisi yang benarKoordinat {start, end}[]

Buat Task — Grid / Classify

Mode yang paling umum. Kirim ubin gambar ter-encode base64 dan teks pertanyaan.

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

Respons

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

Setiap answers[i] sesuai dengan queries[i] — true berarti gambar cocok dengan pertanyaan.

Buat Task — Click

Kirim satu gambar. Solver mengembalikan koordinat objek target.

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

Respons

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

Buat Task — Drag & Drop

Kirim gambar latar di queries dan potongan puzzle di 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"]
    }
}

Respons

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

Parameter Task

PropertyTypeRequiredDescription
typestring✅PopularCaptchaImage atau PopularClassification
questionTypestring✅objectClassify, objectClick, atau objectDrag
questionstring✅Teks instruksi tantangan
queriesstring[]✅Gambar ter-encode base64 (ubin grid atau gambar utama)
examplesstring[]Hanya dragObjek target untuk tugas drag
screenshortbooleanNoAtur true jika gambar berupa screenshot

API Playground

POST
Masuk untuk mengisi API key Anda secara otomatis
Payload
Respons

Tekan Kirim untuk melihat respons

⌘ + Enter

Parameter

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

Kode Error

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
Kode
terminal