Yetenek Matrisi
Tek doğru kaynak — her CaptchaSonic CAPTCHA türünün Python SDK metodu, Node.js SDK metodu, REST taskType değeri ve dönüş alanıyla eşleşmesi.
Yetenek Matrisi, "CaptchaSonic neyi çözer ve nasıl çağırırım?" sorusunun kanonik yanıtıdır. Her satır bir CAPTCHA'yı Python metoduna, Node.js metoduna, REST task.type değerine ve yanıtı tutan tam alana bağlar. Dokümantasyonun, SDK'ların ve harici AI ajanları / MCP istemcilerinin hepsinin okuduğu tek doğru kaynaktır.
TIP
Matrisi ajanlar, otomasyonlar veya kendi panolarınız için JSON olarak indirin: capabilities.json. JSON dosyası src/data/capabilities.ts dosyasını alan alan yansıtır.
Nasıl okunur
- Aile —
tokenbir metin token'ı döndürür (gizli bir form alanına yerleştirin);imageverdiğiniz bir görselden koordinat veya metin döndürür;interactiveyapılandırılmış bir eylem döndürür (tıklama indeksleri, sürükleme delta değerleri vb.). - Python SDK / Node.js SDK — metot adı ve yanıtın bulunduğu, yanıt nesnesi altındaki noktalı yol.
not in SDK, CAPTCHA'ya bugün yalnızca REST API üzerinden ulaşılabildiği anlamına gelir. - REST taskType —
POST /createTaskçağrısındatask.typeolarak gönderdiğiniz tam metin. API ayrı birproxylessvaryantı sunuyorsa (ör.TurnstileTaskProxyless) bu da gösterilir. - Notlar — sabitlenmiş uyarılar (zorunlu argümanlar, proxy gereksinimleri, alt tür anlamları).
Matris
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 |
Sayılar
- Toplam 13 satır — belgelenen her CAPTCHA için bir satır.
- 13 Python SDK metodu ve 13 Node.js SDK metodu (her CAPTCHA için birer tane).
- 5 token ailesi, 4 image ailesi, 4 interactive ailesi.
Bu sayılar üretilmiş capabilities.ts dosyasından canlı okunur; bu yüzden SDK ile uyumlu kalırlar ve yukarıdaki matristen sapamazlar.
Kararlılık garantileri
- Satır eklemek geriye dönük uyumludur. Yeni CAPTCHA'lar
src/data/capabilities.tsiçindekiCAPABILITIESdizisinin sonuna eklenir. - Bir
slugdeğerini kaldırmak veya yeniden adlandırmak, ona bağlanmış ajanlar için kırıcı bir değişikliktir. Bunu sessizce yapmayız. - Metot adları ve dönüş alanları SDK dokümanlarını birebir yansıtır; bir metot yeniden adlandırılırsa bu matris aynı sürümde güncellenir.
Ham REST sözleşmesi için REST API başvurusuna bakın. Uçtan uca kurulum ve hızlı başlangıç için Python SDK ve Node.js SDK sayfalarına bakın.
Hata kodları
Yukarıdaki matris her CAPTCHA'yı metoduna ve dönüş alanına bağlar. Aşağıdaki tablo, her SDK'nın ve REST API'nin bir görev başarısız olduğunda sunduğu sayısal errorId kodları için tek durak başvuru kaynağıdır.
| 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).