Skip to content
CaptchaSonic

Solveur hCaptcha

Résolvez les défis image hCaptcha en fournissant les images encodées en base64 et l'énoncé de la question. L'API utilise le type de tâche PopularCaptchaImage, qui prend en charge trois modes de défi.

Modes pris en charge

ModequestionTypeDescriptionRéponse
Grille / ClassificationobjectClassifySélectionner toutes les images correspondantes dans une grilleboolean[] — une valeur par image
ClicobjectClickCliquer au centre d'un objet cibleCoordonnées {x, y}[]
Glisser-déposerobjectDragFaire glisser les pièces du puzzle à leur position correcteCoordonnées {start, end}[]

Créer une tâche — Grille / Classification

Le mode le plus courant. Envoyez les tuiles d'image encodées en base64 et le texte de la question.

POST/createTask
Hôteapi.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", "..."]
    }
}

Réponse

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

Chaque answers[i] correspond à queries[i] — true signifie que l'image correspond à la question.

Créer une tâche — Clic

Envoyez une seule image. Le solveur renvoie les coordonnées de l'objet cible.

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

Réponse

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

Créer une tâche — Glisser-déposer

Envoyez l'image de fond dans queries et la pièce du puzzle dans 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"]
    }
}

Réponse

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

Paramètres de la tâche

PropriétéTypeRequisDescription
typestring✅PopularCaptchaImage ou PopularClassification
questionTypestring✅objectClassify, objectClick ou objectDrag
questionstring✅Texte de la consigne du défi
queriesstring[]✅Images encodées en base64 (tuiles de grille ou image principale)
examplesstring[]Glisser-déposer uniquementObjets cibles pour les tâches de glisser-déposer
screenshortbooleanNonMettre true si les images sont des captures d'écran

Terrain d'essai de l'API

POST
Se connecter pour renseigner automatiquement votre clé API
Charge utile
Réponse

Cliquez sur Envoyer pour voir la réponse

⌘ + Entrée

Paramètres

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

Codes d'erreur

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