Geetest v4 Captcha Solver | CaptchaSonic Docs

Решайте задачи GeeTest v4 с помощью типа задачи GeetestImage. Установите gtv: 4 и укажите v4-captchaId. Поле question задаёт режим задачи.

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

Режим	`question`	Входные данные	Ответ
Слайд	`slide`	Фон + слайдер (2 изображения)	Координаты `[x, y]`
Иконка	`icon`	Основное изображение + примеры	Координаты кликов
9-сетка	`nine`	9 изображений сетки	Индексы подходящих ячеек
Winlinze	`winlinze`	25 изображений сетки	Индексы ячеек

Создание задачи — Слайд

POST/createTask

Hostapi.captchasonic.com

Content-Typeapplication/json

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "GeetestImage",
        "gtv": 4,
        "question": "slide",
        "queries": ["BASE64_BACKGROUND", "BASE64_SLIDER"],
        "captchaId": "e392e1d7fd421dc63325744d5a2b9c73"
    }
}

Ответ

{
    "code": 200,
    "msg": "",
    "answers": [142, 160]
}

Создание задачи — Клик по иконке

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "GeetestImage",
        "gtv": 4,
        "question": "icon",
        "queries": ["BASE64_MAIN_IMAGE"],
        "examples": ["BASE64_TARGET_1", "BASE64_TARGET_2"],
        "captchaId": "e392e1d7fd421dc63325744d5a2b9c73"
    }
}

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

Параметр	Тип	Обязательный	Описание
`type`	`string`	✅	`GeetestImage` или `GeetestClassification`
`gtv`	`integer`	Нет	Версия GeeTest — `4` для v4
`question`	`string`	✅	`slide`, `icon`, `nine`, `match` или `winlinze`
`queries`	`string[]`	✅	Изображения в base64
`examples`	`string[]`	Только icon	Целевые эталонные изображения
`captchaId`	`string`	✅	`captcha_id` GeeTest v4
`proxy`	`string`	Нет	URL прокси, если требуется

API Playground

POSTapi.captchasonic.com

Payload

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "GeetestImage",
    "gtv": 4,
    "question": "slide",
    "queries": [
      "BASE64_BACKGROUND",
      "BASE64_SLIDER"
    ],
    "captchaId": "e392e1d7fd421dc63325744d5a2b9c73"
  }
}

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "GeetestImage",
    "gtv": 4,
    "question": "slide",
    "queries": [
      "BASE64_BACKGROUND",
      "BASE64_SLIDER"
    ],
    "captchaId": "e392e1d7fd421dc63325744d5a2b9c73"
  }
}

Response

Hit Send to see response

⌘ + Enter

Parameters

apiKeystringYOUR_API_KEY

taskobject{...}

└ typestringGeetestImage

└ gtvnumber4

└ questionstringslide

└ queriesarray[2 items]

└ captchaIdstringe392e1d7fd421dc63325744d5a2b9c…

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