Skip to content

ReCaptcha v2 Image Solver

Select matching images in ReCaptcha v2 grids (cars, buses, traffic lights, etc.) using the ReCaptchaV2Image task type. Returns zero-based indices of the correct tiles.

Create Task

Send base64-encoded image tiles and the question prompt.

POST/createTask
Hostapi.captchasonic.com
Content-Typeapplication/json
{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "ReCaptchaV2Image",
        "question": "Select all crosswalks",
        "queries": ["BASE64_IMG_1", "BASE64_IMG_2", "BASE64_IMG_3"]
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [0, 3, 7]
}

answers contains zero-based indices of the images that match the question.

Task Parameters

PropertyTypeRequiredDescription
typestringβœ…ReCaptchaV2Image or ReCaptchaV2Classification
questionstringβœ…The challenge text (e.g. "Select all crosswalks")
queriesstring[]βœ…Base64-encoded grid tile images

API Playground

POST
Log in to auto-fill your API key
Payload
Response

Hit Send to see response

⌘ + Enter

Parameters

apiKeystringYOUR_API_KEY
taskobject{...}
β”” typestringReCaptchaV2Image
β”” questionstringSelect all crosswalks
β”” queriesarray[2 items]

Error Codes

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