Skip to content
CaptchaSonic

Resolvedor hCaptcha

Resolva desafios de imagem do hCaptcha enviando as imagens codificadas em base64 e o texto da pergunta. A API usa o tipo de tarefa PopularCaptchaImage, que suporta três modos de desafio.

Modos suportados

ModoquestionTypeDescriçãoResposta
Grade / ClassificarobjectClassifySelecione todas as imagens correspondentes em uma gradeboolean[] — uma por imagem
CliqueobjectClickClique no centro de um objeto alvoCoordenadas {x, y}[]
Arrastar e soltarobjectDragArraste as peças do quebra-cabeça para a posição corretaCoordenadas {start, end}[]

Criar tarefa — Grade / Classificar

O modo mais comum. Envie os blocos de imagem em base64 e o texto da pergunta.

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

Resposta

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

Cada answers[i] corresponde a queries[i] — true significa que a imagem corresponde à pergunta.

Criar tarefa — Clique

Envie uma única imagem. O solver retorna as coordenadas do objeto alvo.

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

Resposta

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

Criar tarefa — Arrastar e soltar

Envie a imagem de fundo em queries e a peça do quebra-cabeça em 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"]
    }
}

Resposta

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

Parâmetros da tarefa

PropriedadeTipoObrigatórioDescrição
typestring✅PopularCaptchaImage ou PopularClassification
questionTypestring✅objectClassify, objectClick ou objectDrag
questionstring✅O texto da instrução do desafio
queriesstring[]✅Imagens codificadas em Base64 (blocos da grade ou imagem principal)
examplesstring[]Somente arrastarObjetos alvo para tarefas de arrastar
screenshortbooleanNãoDefina true se as imagens forem capturas de tela

Playground da API

POST
Entrar para preencher automaticamente sua chave de API
Payload
Resposta

Clique em Enviar para ver a resposta

⌘ + Enter

Parâmetros

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

Códigos de erro

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
Código
terminal