Skip to content
CaptchaSonic

Funktionsmatrix

Einzige Referenz — jeder CaptchaSonic-CAPTCHA-Typ zugeordnet zu seiner Python-SDK-Methode, Node.js-SDK-Methode, REST-taskType und dem Rückgabefeld.

Die Funktionsmatrix ist die maßgebliche Antwort auf die Frage „Was löst CaptchaSonic, und wie rufe ich es auf?“. Jede Zeile ordnet einen CAPTCHA-Typ seiner Python-Methode, seiner Node.js-Methode, dem REST-task.type und dem genauen Feld zu, in dem die Antwort steht. Sie ist die einzige Referenz, auf die sich die Dokumentation, die SDKs und externe KI-Agenten / MCP-Clients stützen.

TIP

Laden Sie die Matrix als JSON herunter für Agenten, Automatisierungen oder eigene Dashboards: capabilities.json. Das JSON spiegelt src/data/capabilities.ts Feld für Feld.


So lesen Sie die Matrix

  • Familie — token liefert eine Token-Zeichenkette (die Sie in ein verborgenes Formularfeld einfügen); image liefert Koordinaten oder Text aus einem von Ihnen übergebenen Bild; interactive liefert eine strukturierte Aktion (Klick-Indizes, Ziehdistanzen usw.).
  • Python SDK / Node.js SDK — der Methodenname und der Pfad mit Punkten im Antwortobjekt, unter dem die Antwort steht. not in SDK bedeutet, dass der CAPTCHA-Typ derzeit nur über die REST-API erreichbar ist.
  • REST taskType — die exakte Zeichenkette, die Sie als task.type an POST /createTask übergeben. Eine separate proxyless-Variante wird angezeigt, wenn die API eine solche bereitstellt (z. B. TurnstileTaskProxyless).
  • Hinweise — festgehaltene Einschränkungen (Pflichtargumente, Proxy-Anforderungen, Bedeutung der Untertypen).

Matrix

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

Anzahl

  • 13 Zeilen insgesamt — eine pro dokumentiertem CAPTCHA-Typ.
  • 13 Python-SDK-Methoden und 13 Node.js-SDK-Methoden (je eine pro CAPTCHA-Typ).
  • 5 Token-Familie, 4 Bild-Familie, 4 interaktive Familie.

Diese Zahlen werden live aus der generierten Datei capabilities.ts gelesen und bleiben daher synchron mit dem SDK; sie können nicht von der obigen Matrix abweichen.


Stabilitätsgarantien

  • Neue Zeilen hinzufügen ist nicht breaking. Neue CAPTCHA-Typen werden am Ende von CAPABILITIES in src/data/capabilities.ts angefügt.
  • Das Entfernen oder Umbenennen eines slug ist eine breaking change für jeden Agenten, der sich darauf festgelegt hat. Wir tun dies nicht stillschweigend.
  • Methodennamen und Rückgabefelder entsprechen wortgleich den SDK-Dokumenten — ändert sich ein Methodenname, wird diese Matrix im selben Release aktualisiert.

Die REST-Schnittstelle im Detail finden Sie in der REST-API-Referenz. Für die Installation und den Schnellstart von Anfang bis Ende lesen Sie die Seiten zum Python-SDK und zum Node.js-SDK.


Fehlercodes

Die Matrix oben ordnet jeden CAPTCHA-Typ seiner Methode und seinem Rückgabefeld zu. Die folgende Tabelle ist die passende Übersicht der numerischen errorId-Codes, die alle SDKs und die REST-API bei einem fehlgeschlagenen Task zurückgeben.

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).