Popular Captcha Solver | CaptchaSonic Docs

Решайте задачи с взаимодействием с объектами через типы задач PopularCaptchaImage или PopularClassification. Поле questionType определяет способ обработки задачи.

Поддерживаемые режимы

`questionType`	Описание	Формат ответа
`objectClassify`	Выбрать все подходящие изображения в сетке	`boolean[]` на изображение
`objectClick`	Кликнуть по центру целевого объекта	Координаты `{x, y}[]`
`objectDrag`	Перетащить фрагменты паззла на места	`{start, end}[]`
`objectTag`	Отметить объекты на изображении	Массив меток
`grid`	Универсальный выбор по сетке	Булев массив
`bbox`	Детекция bounding-box	Координаты

Создание задачи — Сетка-классификация

POST/createTask

Hostapi.captchasonic.com

Content-Typeapplication/json

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "PopularCaptchaImage",
        "questionType": "objectClassify",
        "question": "Select all objects with a bridge",
        "queries": ["BASE64_IMG_1", "BASE64_IMG_2"]
    }
}

Ответ

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

Создание задачи — Клик по объекту

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

Создание задачи — Drag по объекту

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

Параметры задачи

Параметр	Тип	Обязательный	Описание
`type`	`string`	✅	`PopularCaptchaImage` или `PopularClassification`
`questionType`	`string`	✅	`objectClassify`, `objectClick`, `objectDrag`, `objectTag`, `grid`, `bbox`
`question`	`string`	✅	Текст инструкции
`queries`	`string[]`	✅	Изображения в base64
`examples`	`string[]`	Только drag	Целевые объекты для drag-задач
`screenshort`	`boolean`	Нет	`true`, если переданы скриншоты

API Playground

POSTapi.captchasonic.com

Payload

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "PopularCaptchaImage",
    "questionType": "objectClassify",
    "question": "Select all objects with a bridge",
    "queries": [
      "BASE64_IMG_1",
      "BASE64_IMG_2"
    ]
  }
}

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "PopularCaptchaImage",
    "questionType": "objectClassify",
    "question": "Select all objects with a bridge",
    "queries": [
      "BASE64_IMG_1",
      "BASE64_IMG_2"
    ]
  }
}

Response

Hit Send to see response

⌘ + Enter

Parameters

apiKeystringYOUR_API_KEY

taskobject{...}

└ typestringPopularCaptchaImage

└ questionTypestringobjectClassify

└ questionstringSelect all objects with a brid…

└ queriesarray[2 items]

Error Codes

1KEY_DOES_NOT_EXIST— API key is invalid or not found.

2NO_SLOT_AVAILABLE— All solver slots are occupied.

3ZERO_BALANCE— Account balance is zero.

10ERROR_BAD_PARAMETERS— Invalid or missing request fields.

12ERROR_CAPTCHA_UNSOLVABLE— Captcha could not be solved.

14PLAN_EXPIRED— Your plan has expired.

16RATE_LIMITED— Too many requests. Slow down.

17DAILY_LIMIT_EXCEEDED— Daily usage limit reached.

18QUOTA_LIMIT_EXCEEDED— Plan quota exhausted.

21SERVICE_UNAVAILABLE— Backend is temporarily unavailable.

Code

terminal