Skip to content

Матрица возможностей

Единый источник истины — каждый тип капчи CaptchaSonic в связке с методом Python SDK, методом Node.js SDK, REST taskType и полем ответа.

Матрица возможностей — это канонический ответ на вопрос «что умеет CaptchaSonic и как это вызвать?». Каждая строка фиксирует капчу, её метод в Python, метод в Node.js, REST task.type и точное поле, в котором находится ответ. Это единый источник истины, к которому обращаются документация, SDK и внешние AI-агенты / MCP-клиенты.

TIP

Скачайте матрицу в JSON для использования в агентах, автоматизациях или собственных дашбордах: capabilities.json. JSON-файл соответствует src/data/capabilities.ts поле в поле.


Как читать таблицу

  • Family (семейство)token возвращает строковый токен (его подставляют в скрытое поле формы); image возвращает координаты или текст по изображению, которое вы прислали; interactive возвращает структурированное действие (индексы клика, смещение и т. д.).
  • Python SDK / Node.js SDK — имя метода и dotted-путь по объекту ответа, где лежит результат. not in SDK означает, что эта капча доступна только через REST API.
  • REST taskType — точная строка, которую нужно передать в task.type запроса POST /createTask. Если API предлагает отдельный proxyless-вариант (например, TurnstileTaskProxyless), он указан рядом.
  • Notes (заметки) — обязательные оговорки (требуемые аргументы, прокси, варианты подтипов).

Матрица

13 capabilities
5 token4 image4 interactive
capabilities.json
token

Token solvers5

Submit website_url + website_key. The SDK polls our infrastructure and returns a ready-to-submit token (~6–12s typical).

CaptchaPythonNode.jsREST task type
reCAPTCHA v2 (token)
Solve a reCAPTCHA v2 token challenge via browser automation (async — polls until ready).
solve_recaptcha_v2_token
solution.token
solveRecaptchaV2Token
solution.token
RecaptchaV2Task
+ RecaptchaV2TaskProxyless
reCAPTCHA v3 (token)
Solve a reCAPTCHA v3 token challenge via browser automation (async — polls until ready).
solve_recaptcha_v3_token
solution.token
solveRecaptchaV3Token
solution.token
RecaptchaV3Task
+ RecaptchaV3TaskProxyless
Cloudflare Turnstile
Solve a Cloudflare Turnstile token challenge (async — polls until ready).
solve_turnstile
solution.token
solveTurnstile
solution.token
AntiTurnstileTask
Cloudflare Challenge
Solve a Cloudflare challenge via browser automation (async — polls until ready).
solve_cloudflare
solution.token
proxy
solveCloudflare
solution.token
proxy
AntiCloudflareTask
PopularCaptcha (token)
Solve a popular CAPTCHA token challenge via browser automation (async — polls until ready).
solve_popular_captcha_token
solution.token
solvePopularCaptchaToken
solution.token
PopularTask
+ PopularTaskProxyless
image

Image solvers4

You supply the challenge images; the SDK returns a typed_solution payload describing what to do (tile indices, text, slide offset).

CaptchaPythonNode.jsREST task type
reCAPTCHA v2 (image grid)
Solve a reCAPTCHA v2 image classification challenge.
solve_recaptcha_v2
typed_solution.grid.objects
solveRecaptchaV2
typedSolution.grid.objects
RecaptchaV2Classification
AWS WAF
Solve an AWS WAF image challenge.
solve_aws_waf
typed_solution.grid.objects
solveAwsWaf
typedSolution.grid.objects
AwsWafClassification
Image-to-text (OCR)
Solve an OCR / image-to-text task.
solve_ocr
typed_solution.text.texts[0]
solveOcr
typedSolution.text.texts[0]
ImageToTextTask
Slide puzzle
Solve a slide CAPTCHA using local alpha/contour detection (no AI).
solve_slide_image
typed_solution.slide.x
solveSlideImage
typedSolution.slide.x
SlideImage
interactive

Interactive solvers4

Images plus extra metadata for slide / click / whirl variants. Return shape varies by sub-type.

CaptchaPythonNode.jsREST task type
PopularCaptcha
Solve a popular CAPTCHA image classification challenge (grid/bbox/drag).
solve_popular_captcha
typed_solution.grid.objects
solvePopularCaptcha
typedSolution.grid.objects
PopularCaptchaImage
GeeTest
Solve a Geetest CAPTCHA challenge.
solve_geetest
typed_solution
solveGeetest
typedSolution
GeetestClassification
TikTok
Solve a TikTok CAPTCHA challenge.
solve_tiktok
typed_solution
solveTikTok
typedSolution
TikTokClassification
Binance
Solve a Binance CAPTCHA challenge.
solve_binance
typed_solution
solveBinance
typedSolution
BinanceSlideTask

Количество строк

  • 13 строк всего — по одной на каждую задокументированную капчу.
  • 13 методов в Python SDK и 13 в Node.js SDK (по одному на капчу).
  • 5 в семействе token, 4 image, 4 interactive.

Гарантии стабильности

  • Добавление строк не ломает совместимость. Новые капчи дописываются в конец массива CAPABILITIES в src/data/capabilities.ts.
  • Удаление или переименование slug — ломающее изменение для агентов, привязавшихся к идентификатору. Молча мы такого не делаем.
  • Имена методов и возвращаемые поля дословно совпадают с SDK-документацией — переименование метода фиксируется в матрице в том же релизе.

Сырые REST-контракты см. в справочнике REST API. Установка и быстрый старт — на страницах Python SDK и Node.js SDK.