Matriks Kemampuan
Sumber tunggal kebenaran — setiap jenis captcha CaptchaSonic dipetakan ke metode Python SDK, metode Node.js SDK, REST taskType, dan field hasilnya.
Matriks Kemampuan adalah jawaban baku untuk pertanyaan "CaptchaSonic menyelesaikan apa, dan bagaimana cara memanggilnya?". Setiap baris menghubungkan captcha dengan metode Python, metode Node.js, task.type REST, dan field yang tepat yang berisi jawabannya. Ini adalah sumber tunggal kebenaran yang dibaca oleh dokumentasi, SDK, dan AI agent / client MCP eksternal.
TIP
Unduh matriks sebagai JSON untuk digunakan di agent, otomatisasi, atau dashboard Anda sendiri: capabilities.json. JSON ini mencerminkan src/data/capabilities.ts field demi field.
Cara membaca
- Family —
tokenmengembalikan token string (masukkan ke field form tersembunyi);imagemengembalikan koordinat atau teks dari gambar yang Anda berikan;interactivemengembalikan aksi terstruktur (indeks klik, selisih seret, dll.). - Python SDK / Node.js SDK — nama metode dan jalur bertitik di bawah objek respons tempat jawabannya berada.
not in SDKberarti captcha tersebut saat ini hanya dapat diakses melalui REST API. - REST taskType — string persis yang Anda kirim sebagai
task.typekePOST /createTask. Varianproxylessterpisah ditampilkan jika API menyediakannya (mis.TurnstileTaskProxyless). - Catatan — peringatan yang disematkan (argumen wajib, syarat proxy, makna subtype).
Matriks
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 |
Jumlah
- 13 baris seluruhnya — satu per captcha yang terdokumentasi.
- 13 metode Python SDK dan 13 metode Node.js SDK (masing-masing satu per captcha).
- 5 family token, 4 family image, 4 family interactive.
Jumlah ini dibaca secara langsung dari capabilities.ts yang dihasilkan, sehingga selalu mengikuti SDK dan tidak akan menyimpang dari matriks di atas.
Jaminan stabilitas
- Menambah baris tidak memutus kompatibilitas. Captcha baru ditambahkan di bagian bawah
CAPABILITIESdalamsrc/data/capabilities.ts. - Menghapus atau mengganti nama
slugadalah perubahan yang memutus kompatibilitas bagi agent mana pun yang terikat padanya. Kami tidak akan melakukannya secara diam-diam. - Nama metode dan field hasil mengikuti dokumentasi SDK secara persis — jika sebuah metode diganti namanya, matriks ini diperbarui dalam rilis yang sama.
Untuk kontrak REST mentah, lihat referensi REST API. Untuk instalasi dan quick-start menyeluruh, lihat halaman Python SDK dan Node.js SDK.
Kode error
Matriks di atas menghubungkan setiap captcha dengan metode dan field hasilnya. Tabel di bawah adalah referensi terpadu untuk kode numerik errorId yang dikembalikan oleh setiap SDK dan REST API saat sebuah task gagal.
| 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).