क्षमता मैट्रिक्स
एकमात्र स्रोत — हर CaptchaSonic CAPTCHA प्रकार उसकी Python SDK मेथड, Node.js SDK मेथड, REST taskType और रिटर्न फ़ील्ड से मैप किया गया।
Capability Matrix इस सवाल का मानक उत्तर है कि "CaptchaSonic क्या हल करता है, और मैं उसे कैसे कॉल करूँ?" हर पंक्ति किसी CAPTCHA को उसकी Python मेथड, Node.js मेथड, REST task.type, और उस सटीक फ़ील्ड से जोड़ती है जिसमें उत्तर होता है। यही एकमात्र स्रोत है, जिसे डॉक्स, SDKs और बाहरी AI एजेंट / MCP क्लाइंट सभी पढ़ते हैं।
TIP
एजेंट, ऑटोमेशन या अपने डैशबोर्ड में उपयोग के लिए मैट्रिक्स को JSON के रूप में डाउनलोड करें: capabilities.json। यह JSON src/data/capabilities.ts को फ़ील्ड-दर-फ़ील्ड दर्शाता है।
इसे कैसे पढ़ें
- Family —
tokenएक स्ट्रिंग टोकन लौटाता है (इसे छिपे फ़ॉर्म फ़ील्ड में डालें);imageआपकी दी गई इमेज से निर्देशांक या टेक्स्ट लौटाता है;interactiveएक संरचित क्रिया लौटाता है (क्लिक इंडेक्स, ड्रैग डेल्टा आदि)। - Python SDK / Node.js SDK — मेथड का नाम और रिस्पॉन्स ऑब्जेक्ट के अंतर्गत वह डॉटेड पाथ जहाँ उत्तर होता है।
not in SDKका अर्थ है कि उस CAPTCHA तक आज केवल REST API के ज़रिए पहुँचा जा सकता है। - REST taskType — वह सटीक स्ट्रिंग जो आप
POST /createTaskमेंtask.typeके रूप में पास करते हैं। जब API एकproxylessवेरिएंट देता है, तो वह अलग से दिखाया जाता है (जैसेTurnstileTaskProxyless)। - Notes — पिन की गई चेतावनियाँ (आवश्यक आर्गुमेंट, प्रॉक्सी आवश्यकताएँ, subtype का अर्थ)।
मैट्रिक्स
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 पंक्तियाँ — हर दस्तावेज़ित CAPTCHA के लिए एक।
- 13 Python SDK मेथड और 13 Node.js SDK मेथड (हर CAPTCHA के लिए एक-एक)।
- 5 token-family, 4 image-family, 4 interactive-family।
ये गिनतियाँ जनरेट की गई capabilities.ts से लाइव पढ़ी जाती हैं, इसलिए ये SDK के साथ चलती हैं और ऊपर के मैट्रिक्स से अलग नहीं हो सकतीं।
स्थिरता की गारंटी
- पंक्तियाँ जोड़ना गैर-ब्रेकिंग है। नए CAPTCHA
src/data/capabilities.tsमेंCAPABILITIESके नीचे जुड़ते हैं। slugहटाना या उसका नाम बदलना किसी भी ऐसे एजेंट के लिए ब्रेकिंग बदलाव है जिसने उसे पिन किया हो। हम ऐसा चुपचाप नहीं करेंगे।- मेथड के नाम और रिटर्न फ़ील्ड SDK डॉक्स को शब्दशः दर्शाते हैं — यदि कोई मेथड नाम बदलती है, तो यह मैट्रिक्स उसी रिलीज़ में अपडेट होगा।
कच्चे REST कॉन्ट्रैक्ट के लिए REST API reference देखें। एंड-टू-एंड इंस्टॉल / क्विक-स्टार्ट के लिए Python SDK और Node.js SDK पेज देखें।
एरर कोड
ऊपर का मैट्रिक्स हर CAPTCHA को उसकी मेथड और रिटर्न फ़ील्ड से जोड़ता है। नीचे की तालिका उन संख्यात्मक errorId कोड का मिलता-जुलता एक-स्थान संदर्भ है, जिन्हें हर SDK और REST API तब दिखाते हैं जब कोई टास्क विफल होता है।
| id | Python exception | Node errorName | Meaning | Action |
|---|---|---|---|---|
0 | SonicError | SonicError | Base class for every SDK error — catches anything below. | Inspect `error.errorId` (Node) / `err.error_id` (Python) and branch. |
1 | InvalidApiKeyError | InvalidApiKeyError | API key is missing, malformed, or revoked. | Verify the key in your dashboard. |
2 | InsufficientBalanceError | InsufficientBalanceError | Account balance can't cover the task. | Add funds. |
3 | DailyLimitExceededError | DailyLimitExceededError | Daily quota exhausted. | Wait for the daily reset or upgrade your plan. |
4 | MinuteLimitExceededError | MinuteLimitExceededError | Per-minute rate limit hit. | Slow down requests / add exponential backoff. |
5 | QuotaExceededError | QuotaExceededError | Plan quota exhausted. | Upgrade your plan. |
6 | PlanExpiredError | PlanExpiredError | Subscription has expired. | Renew your subscription. |
Every concrete row inherits from SonicError — catch it once to handle all SDK failures, or branch on errorId / exception subclass for granular control. Transient gRPC errors are retried automatically with exponential backoff (up to 3 attempts).