Skip to content
CaptchaSonic

HCaptcha Çözücü

Base64 kodlu görselleri ve soru istemini sağlayarak hCaptcha görsel challenge'larını çözün. API, üç challenge modunu destekleyen PopularCaptchaImage görev türünü kullanır.

Desteklenen modlar

ModquestionTypeAçıklamaYanıt
Izgara / SınıflandırmaobjectClassifyIzgaradan eşleşen tüm görselleri seçinboolean[] — resim başına bir tane
TıklamaobjectClickHedef nesnenin ortasına tıklayın{x, y}[] koordinatları
Sürükle ve bırakobjectDragBulmaca parçalarını doğru konumlarına sürükleyin{start, end}[] koordinatları

Görev oluştur — Izgara / Sınıflandırma

En yaygın mod. Base64 kodlu görsel karelerini ve soru metnini gönderin.

POST/createTask
Ana bilgisayarapi.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", "..."]
    }
}

Yanıt

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

Her answers[i], queries[i] ile eşleşir — true, görselin soruyla eşleştiği anlamına gelir.

Görev oluştur — Tıklama

Tek bir görsel gönderin. Çözücü hedef nesnenin koordinatlarını döndürür.

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

Yanıt

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

Görev oluştur — Sürükle ve bırak

Arka plan görselini queries içinde, bulmaca parçasını examples içinde gönderin.

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "PopularCaptchaImage",
        "questionType": "objectDrag",
        "question": "Drag the puzzle piece to the gap",
        "queries": ["BASE64_BACKGROUND"],
        "examples": ["BASE64_PUZZLE_PIECE"]
    }
}

Yanıt

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

Görev parametreleri

ÖzellikTürGerekliAçıklama
typestring✅PopularCaptchaImage veya PopularClassification
questionTypestring✅objectClassify, objectClick veya objectDrag
questionstring✅Challenge talimat metni
queriesstring[]✅Base64 kodlu görseller (ızgara kareleri veya ana görsel)
examplesstring[]Yalnızca sürüklemeSürükleme görevleri için hedef nesneler
screenshortbooleanHayırGörseller ekran görüntüsüyse true olarak ayarlayın

API Playground

POST
Giriş yap API anahtarınızı otomatik doldurmak için
Yük
Yanıt

Yanıtı görmek için Gönder'e basın

⌘ + Enter

Parametreler

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

Hata kodları

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