Матрица возможностей
Единый источник истины — каждый тип капчи 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 (заметки) — обязательные оговорки (требуемые аргументы, прокси, варианты подтипов).
Матрица
Token solvers5
Submit website_url + website_key. The SDK polls our infrastructure and returns a ready-to-submit token (~6–12s typical).
| Captcha | Python | Node.js | REST task type |
|---|---|---|---|
| reCAPTCHA v2 (token) Solve a reCAPTCHA v2 token challenge via browser automation (async — polls until ready). | solve_recaptcha_v2_tokensolution.token | solveRecaptchaV2Tokensolution.token | RecaptchaV2Task+ RecaptchaV2TaskProxyless |
| reCAPTCHA v3 (token) Solve a reCAPTCHA v3 token challenge via browser automation (async — polls until ready). | solve_recaptcha_v3_tokensolution.token | solveRecaptchaV3Tokensolution.token | RecaptchaV3Task+ RecaptchaV3TaskProxyless |
| Cloudflare Turnstile Solve a Cloudflare Turnstile token challenge (async — polls until ready). | solve_turnstilesolution.token | solveTurnstilesolution.token | AntiTurnstileTask |
| Cloudflare Challenge Solve a Cloudflare challenge via browser automation (async — polls until ready). | solve_cloudflaresolution.tokenproxy | solveCloudflaresolution.tokenproxy | AntiCloudflareTask |
| PopularCaptcha (token) Solve a popular CAPTCHA token challenge via browser automation (async — polls until ready). | solve_popular_captcha_tokensolution.token | solvePopularCaptchaTokensolution.token | PopularTask+ PopularTaskProxyless |
Image solvers4
You supply the challenge images; the SDK returns a typed_solution payload describing what to do (tile indices, text, slide offset).
| Captcha | Python | Node.js | REST task type |
|---|---|---|---|
| reCAPTCHA v2 (image grid) Solve a reCAPTCHA v2 image classification challenge. | solve_recaptcha_v2typed_solution.grid.objects | solveRecaptchaV2typedSolution.grid.objects | RecaptchaV2Classification |
| AWS WAF Solve an AWS WAF image challenge. | solve_aws_waftyped_solution.grid.objects | solveAwsWaftypedSolution.grid.objects | AwsWafClassification |
| Image-to-text (OCR) Solve an OCR / image-to-text task. | solve_ocrtyped_solution.text.texts[0] | solveOcrtypedSolution.text.texts[0] | ImageToTextTask |
| Slide puzzle Solve a slide CAPTCHA using local alpha/contour detection (no AI). | solve_slide_imagetyped_solution.slide.x | solveSlideImagetypedSolution.slide.x | SlideImage |
Interactive solvers4
Images plus extra metadata for slide / click / whirl variants. Return shape varies by sub-type.
| Captcha | Python | Node.js | REST task type |
|---|---|---|---|
| PopularCaptcha Solve a popular CAPTCHA image classification challenge (grid/bbox/drag). | solve_popular_captchatyped_solution.grid.objects | solvePopularCaptchatypedSolution.grid.objects | PopularCaptchaImage |
| GeeTest Solve a Geetest CAPTCHA challenge. | solve_geetesttyped_solution | solveGeetesttypedSolution | GeetestClassification |
| TikTok Solve a TikTok CAPTCHA challenge. | solve_tiktoktyped_solution | solveTikToktypedSolution | TikTokClassification |
| Binance Solve a Binance CAPTCHA challenge. | solve_binancetyped_solution | solveBinancetypedSolution | 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.