Skip to content
CaptchaSonic

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 — token bir metin token'ı döndürür (gizli bir form alanına yerleştirin); image verdiğiniz bir görselden koordinat veya metin döndürür; interactive yapı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ında task.type olarak gönderdiğiniz tam metin. API ayrı bir proxyless varyantı sunuyorsa (ör. TurnstileTaskProxyless) bu da gösterilir.
  • Notlar — sabitlenmiş uyarılar (zorunlu argümanlar, proxy gereksinimleri, alt tür anlamları).

Matris

13 capabilities
5 token4 image4 interactive
capabilities.json
token

Token solvers5

Submit website_url + website_key. The SDK polls our infrastructure and returns a ready-to-submit token (~6–12s typical).

CaptchaPythonNode.jsREST task type
reCAPTCHA v2 (token)
Solve a reCAPTCHA v2 token challenge via browser automation (async — polls until ready).
solve_recaptcha_v2_token
solution.token
solveRecaptchaV2Token
solution.token
RecaptchaV2Task
+ RecaptchaV2TaskProxyless
reCAPTCHA v3 (token)
Solve a reCAPTCHA v3 token challenge via browser automation (async — polls until ready).
solve_recaptcha_v3_token
solution.token
solveRecaptchaV3Token
solution.token
RecaptchaV3Task
+ RecaptchaV3TaskProxyless
Cloudflare Turnstile
Solve a Cloudflare Turnstile token challenge (async — polls until ready).
solve_turnstile
solution.token
solveTurnstile
solution.token
AntiTurnstileTask
Cloudflare Challenge
Solve a Cloudflare challenge via browser automation (async — polls until ready).
solve_cloudflare
solution.token
proxy
solveCloudflare
solution.token
proxy
AntiCloudflareTask
PopularCaptcha (token)
Solve a popular CAPTCHA token challenge via browser automation (async — polls until ready).
solve_popular_captcha_token
solution.token
solvePopularCaptchaToken
solution.token
PopularTask
+ PopularTaskProxyless
image

Image solvers4

You supply the challenge images; the SDK returns a typed_solution payload describing what to do (tile indices, text, slide offset).

CaptchaPythonNode.jsREST task type
reCAPTCHA v2 (image grid)
Solve a reCAPTCHA v2 image classification challenge.
solve_recaptcha_v2
typed_solution.grid.objects
solveRecaptchaV2
typedSolution.grid.objects
RecaptchaV2Classification
AWS WAF
Solve an AWS WAF image challenge.
solve_aws_waf
typed_solution.grid.objects
solveAwsWaf
typedSolution.grid.objects
AwsWafClassification
Image-to-text (OCR)
Solve an OCR / image-to-text task.
solve_ocr
typed_solution.text.texts[0]
solveOcr
typedSolution.text.texts[0]
ImageToTextTask
Slide puzzle
Solve a slide CAPTCHA using local alpha/contour detection (no AI).
solve_slide_image
typed_solution.slide.x
solveSlideImage
typedSolution.slide.x
SlideImage
interactive

Interactive solvers4

Images plus extra metadata for slide / click / whirl variants. Return shape varies by sub-type.

CaptchaPythonNode.jsREST task type
PopularCaptcha
Solve a popular CAPTCHA image classification challenge (grid/bbox/drag).
solve_popular_captcha
typed_solution.grid.objects
solvePopularCaptcha
typedSolution.grid.objects
PopularCaptchaImage
GeeTest
Solve a Geetest CAPTCHA challenge.
solve_geetest
typed_solution
solveGeetest
typedSolution
GeetestClassification
TikTok
Solve a TikTok CAPTCHA challenge.
solve_tiktok
typed_solution
solveTikTok
typedSolution
TikTokClassification
Binance
Solve a Binance CAPTCHA challenge.
solve_binance
typed_solution
solveBinance
typedSolution
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.ts içindeki CAPABILITIES dizisinin sonuna eklenir.
  • Bir slug değ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.

errors7 canonical `errorId` codes
idPython exceptionNode errorNameMeaningAction
0SonicErrorSonicErrorBase class for every SDK error — catches anything below.Inspect `error.errorId` (Node) / `err.error_id` (Python) and branch.
1InvalidApiKeyErrorInvalidApiKeyErrorAPI key is missing, malformed, or revoked.Verify the key in your dashboard.
2InsufficientBalanceErrorInsufficientBalanceErrorAccount balance can't cover the task.Add funds.
3DailyLimitExceededErrorDailyLimitExceededErrorDaily quota exhausted.Wait for the daily reset or upgrade your plan.
4MinuteLimitExceededErrorMinuteLimitExceededErrorPer-minute rate limit hit.Slow down requests / add exponential backoff.
5QuotaExceededErrorQuotaExceededErrorPlan quota exhausted.Upgrade your plan.
6PlanExpiredErrorPlanExpiredErrorSubscription 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).