Skip to content
CaptchaSonic

Solucionador de hCaptcha

Resuelve los desafíos de imagen de hCaptcha enviando las imágenes en base64 y el texto de la pregunta. La API usa el tipo de tarea PopularCaptchaImage, que admite tres modos de desafío.

Modos admitidos

ModoquestionTypeDescripciónRespuesta
Cuadrícula / ClasificarobjectClassifySelecciona todas las imágenes que coinciden en una cuadrículaboolean[] — una por imagen
ClicobjectClickHaz clic en el centro de un objeto objetivoCoordenadas {x, y}[]
Arrastrar y soltarobjectDragArrastra las piezas del puzle a su posición correctaCoordenadas {start, end}[]

Crear tarea — Cuadrícula / Clasificar

El modo más habitual. Envía las casillas de imagen en base64 y el texto de la pregunta.

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

Respuesta

{
    "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 la imagen coincide con la pregunta.

Crear tarea — Clic

Envía una sola imagen. El solver devuelve las coordenadas del objeto objetivo.

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

Respuesta

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

Crear tarea — Arrastrar y soltar

Envía la imagen de fondo en queries y la pieza del puzle en 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"]
    }
}

Respuesta

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

Parámetros de la tarea

PropiedadTipoObligatorioDescripción
typestring✅PopularCaptchaImage o PopularClassification
questionTypestring✅objectClassify, objectClick o objectDrag
questionstring✅Texto de la instrucción del desafío
queriesstring[]✅Imágenes codificadas en base64 (casillas de la cuadrícula o imagen principal)
examplesstring[]Solo arrastrarObjetos objetivo para las tareas de arrastre
screenshortbooleanNoDefine true si las imágenes son capturas de pantalla

Playground de la API

POST
Inicia sesión para rellenar automáticamente tu clave API
Payload
Respuesta

Pulsa Enviar para ver la respuesta

⌘ + Intro

Parámetros

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

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