能力矩阵
单一可信来源 — 每一种 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：方法名以及响应对象中结果所在的点分路径。
not in SDK表示该验证码目前仅能通过 REST 调用。 - REST taskType：调用
POST /createTask时task.type字段的精确字符串。如果接口提供 proxyless 变体（如TurnstileTaskProxyless），会单独列出。 - Notes（备注）：固定注意事项（必填参数、代理要求、子类型语义等）。
矩阵
13 capabilities
5 token4 image4 interactivePython 13/13, Node 13/13
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 行 —— 每个已文档化的验证码占一行。
- Python SDK 覆盖 13 个方法，Node.js SDK 覆盖 13 个方法（每个验证码一个）。
- 家族分布：token 5，image 4，interactive 4。
稳定性承诺
- 新增行为非破坏性变更。新的验证码会追加到
src/data/capabilities.ts中CAPABILITIES的末尾。 - 删除或重命名
slug对已绑定该 ID 的智能体属于破坏性变更，我们不会静默处理。 - 方法名和返回字段与 SDK 文档逐字一致 —— 若方法改名，矩阵会在同一版本中同步更新。
REST 协议原始定义见 REST API 参考；端到端安装与快速上手见 Python SDK 与 Node.js SDK 页面。