Skip to content

Providers

The four shipped provider packages. Each exposes its facade clients (<Provider>Client / Async<Provider>Client), concrete challenge and solution classes, and the adapter.

2Captcha

2Captcha provider package: challenges, solutions, adapter, facades.

Import model (architecture §9): eager subpackage imports; the root unicaptcha package does not preload providers.

TwoCaptchaAdapter

Bases: AntiCaptchaCompatAdapterBase

Adapter speaking 2Captcha's modern JSON API.

TwoCaptchaFunCaptchaChallenge dataclass

Bases: FunCaptchaChallenge

Arkose Labs FunCaptcha extras (ADR-0076: data blob + subdomain).

TwoCaptchaGeeTestV3Challenge dataclass

Bases: GeeTestV3Challenge

GeeTest v3 with optional API-server subdomain.

TwoCaptchaGeeTestV4Challenge dataclass

Bases: GeeTestV4Challenge

GeeTest v4 (risk_type rides top-level, per 2Captcha docs).

TwoCaptchaHCaptchaChallenge dataclass

Bases: HCaptchaChallenge

hCaptcha with optional enterprise payload and worker context.

TwoCaptchaImageChallenge dataclass

Bases: ImageChallenge

Image captcha with 2Captcha's solving hints (ADR-0076).

TwoCaptchaRecaptchaV2Challenge dataclass

Bases: RecaptchaV2Challenge

reCAPTCHA v2 (optionally enterprise) with worker context.

TwoCaptchaRecaptchaV3Challenge dataclass

Bases: RecaptchaV3Challenge

reCAPTCHA v3. Proxyless-only on 2Captcha (no documented proxy variant), and the wire task carries no userAgent/cookies fields, so this subclass adds no extras.

TwoCaptchaTextChallenge dataclass

Bases: TextChallenge

Question captcha; carries the worker-pool hint (languagePool envelope field in the wire payload).

TwoCaptchaTurnstileChallenge dataclass

Bases: TurnstileChallenge

Cloudflare Turnstile with 2Captcha's worker context.

AsyncTwoCaptchaClient

Asyncio-native facade over the 2Captcha JSON API.

TwoCaptchaClient

Blocking facade over the 2Captcha JSON API.

TwoCaptchaFunCaptchaSolution dataclass

Bases: FunCaptchaSolution

Solved Arkose Labs FunCaptcha token.

TwoCaptchaGeeTestV3Solution dataclass

Bases: GeeTestV3Solution

Solved GeeTest v3 three-part answer.

TwoCaptchaGeeTestV4Solution dataclass

Bases: GeeTestV4Solution

Solved GeeTest v4 five-part answer.

TwoCaptchaHCaptchaSolution dataclass

Bases: HCaptchaSolution

Solved hCaptcha token.

TwoCaptchaImageSolution dataclass

Bases: ImageSolution

Solved image captcha text.

TwoCaptchaRecaptchaV2Solution dataclass

Bases: RecaptchaV2Solution

Solved reCAPTCHA v2 token.

TwoCaptchaRecaptchaV3Solution dataclass

Bases: RecaptchaV3Solution

Solved reCAPTCHA v3 token with score/action when reported.

TwoCaptchaTextSolution dataclass

Bases: TextSolution

Solved question-captcha answer text.

TwoCaptchaTurnstileSolution dataclass

Bases: TurnstileSolution

Solved Cloudflare Turnstile token.

Anti-Captcha

Anti-Captcha provider package: challenges, solutions, adapter, facades.

Import model (architecture §9): eager subpackage imports; the root unicaptcha package does not preload providers.

AntiCaptchaAdapter

Bases: AntiCaptchaCompatAdapterBase

Adapter speaking Anti-Captcha's createTask/getTaskResult API.

AntiCaptchaFunCaptchaChallenge dataclass

Bases: FunCaptchaChallenge

Arkose Labs FunCaptcha extras (ADR-0076: data blob + subdomain).

AntiCaptchaGeeTestV3Challenge dataclass

Bases: GeeTestV3Challenge

GeeTest v3 with optional API-server subdomain and get-lib script.

AntiCaptchaGeeTestV4Challenge dataclass

Bases: GeeTestV4Challenge

GeeTest v4: the captcha id rides gt; risk_type lives in initParameters per the official SDK.

AntiCaptchaHCaptchaChallenge dataclass

Bases: HCaptchaChallenge

hCaptcha with optional enterprise payload and worker context (userAgent rides even proxyless).

AntiCaptchaImageChallenge dataclass

Bases: ImageChallenge

Image captcha with Anti-Captcha's solving hints and worker pool.

AntiCaptchaRecaptchaV2Challenge dataclass

Bases: RecaptchaV2Challenge

reCAPTCHA v2 with Anti-Captcha's stoken/data-s extras.

Enterprise tasks drop websiteSToken/recaptchaDataSValue/isInvisible on the wire; data_s rides enterprisePayload there instead.

AntiCaptchaRecaptchaV3Challenge dataclass

Bases: RecaptchaV3Challenge

reCAPTCHA v3. Proxyless-only on Anti-Captcha; the wire task carries no userAgent/cookies fields.

AntiCaptchaTextChallenge dataclass

Bases: TextChallenge

Question captcha; the API's TextCaptchaTask (absent from the official SDK — lang mapping verified at implementation time).

AntiCaptchaTurnstileChallenge dataclass

Bases: TurnstileChallenge

Cloudflare Turnstile. The SDK sends isInvisible on proxy-on tasks only; no universal field exists for it, so it stays unset.

AntiCaptchaClient

Blocking facade over the Anti-Captcha JSON API.

AsyncAntiCaptchaClient

Asyncio-native facade over the Anti-Captcha JSON API.

AntiCaptchaFunCaptchaSolution dataclass

Bases: FunCaptchaSolution

Solved Arkose Labs FunCaptcha token.

AntiCaptchaGeeTestV3Solution dataclass

Bases: GeeTestV3Solution

Solved GeeTest v3 three-part answer.

AntiCaptchaGeeTestV4Solution dataclass

Bases: GeeTestV4Solution

Solved GeeTest v4 five-part answer.

AntiCaptchaHCaptchaSolution dataclass

Bases: HCaptchaSolution

Solved hCaptcha token with worker context.

AntiCaptchaImageSolution dataclass

Bases: ImageSolution

Solved image captcha text.

AntiCaptchaRecaptchaV2Solution dataclass

Bases: RecaptchaV2Solution

Solved reCAPTCHA v2 token with worker context.

user_agent mirrors the response's userAgent (tokens can be UA-bound); resp_key carries the response's respKey when the provider returns one.

AntiCaptchaRecaptchaV3Solution dataclass

Bases: RecaptchaV3Solution

Solved reCAPTCHA v3 token.

AntiCaptchaTextSolution dataclass

Bases: TextSolution

Solved question-captcha answer text.

AntiCaptchaTurnstileSolution dataclass

Bases: TurnstileSolution

Solved Cloudflare Turnstile token.

CapMonster Cloud

CapMonster Cloud provider package: challenges, solutions, adapter, facades.

Import model (architecture §9): eager subpackage imports; the root unicaptcha package does not preload providers.

CapMonsterAdapter

Bases: AntiCaptchaCompatAdapterBase

Adapter speaking CapMonster Cloud's createTask/getTaskResult API.

CapMonsterFunCaptchaChallenge dataclass

Bases: FunCaptchaChallenge

Arkose Labs FunCaptcha extras (data blob + subdomain).

CapMonsterGeeTestV3Challenge dataclass

Bases: GeeTestV3Challenge

GeeTest v3 with optional API-server subdomain and get-lib script.

CapMonsterGeeTestV4Challenge dataclass

Bases: GeeTestV4Challenge

GeeTest v4: the captcha id rides gt (vendor SDK requires it unconditionally, v4 included); risk_type rides initParameters.riskType.

CapMonsterHCaptchaChallenge dataclass

Bases: HCaptchaChallenge

hCaptcha; rqdata rides the wire data field, plus a fallback-UA flag.

CapMonsterImageChallenge dataclass

Bases: ImageChallenge

Image captcha with CapMonster's recognition-module hints.

numeric accepts only 0/1 on CapMonster (unlike 2Captcha/Anti-Captcha where it ranges 0-4).

CapMonsterRecaptchaV2Challenge dataclass

Bases: RecaptchaV2Challenge

reCAPTCHA v2 with CapMonster's enterprise task type and action.

CapMonsterRecaptchaV3Challenge dataclass

Bases: RecaptchaV3Challenge

reCAPTCHA v3. Proxyless-only; min_score validated 0.1-0.9. Enterprise is a separate task type on CapMonster.

CapMonsterTurnstileChallenge dataclass

Bases: TurnstileChallenge

Cloudflare Turnstile. v1 supports cloudflare_task_type="token" only: cf_clearance/wait_room need a proxy, impossible under the proxyless rule (ADR-0076).

AsyncCapMonsterClient

Asyncio-native facade over the CapMonster JSON API.

CapMonsterClient

Blocking facade over the CapMonster JSON API.

CapMonsterFunCaptchaSolution dataclass

Bases: FunCaptchaSolution

Solved Arkose Labs FunCaptcha token.

CapMonsterGeeTestV3Solution dataclass

Bases: GeeTestV3Solution

Solved GeeTest v3 three-part answer.

CapMonsterGeeTestV4Solution dataclass

Bases: GeeTestV4Solution

Solved GeeTest v4 five-part answer.

CapMonsterHCaptchaSolution dataclass

Bases: HCaptchaSolution

Solved hCaptcha token.

CapMonsterImageSolution dataclass

Bases: ImageSolution

Solved image captcha text.

CapMonsterRecaptchaV2Solution dataclass

Bases: RecaptchaV2Solution

Solved reCAPTCHA v2 token.

CapMonsterRecaptchaV3Solution dataclass

Bases: RecaptchaV3Solution

Solved reCAPTCHA v3 token.

CapMonsterTurnstileSolution dataclass

Bases: TurnstileSolution

Solved Cloudflare Turnstile token.

Capsolver

Capsolver provider package: challenges, solutions, adapter, facades.

Import model (architecture §9): eager subpackage imports; the root unicaptcha package does not preload providers.

CapsolverAdapter

Bases: AntiCaptchaCompatAdapterBase

Adapter speaking Capsolver's createTask/getTaskResult API.

CapsolverFunCaptchaChallenge dataclass

Bases: FunCaptchaChallenge

Arkose Labs FunCaptcha; only public_keywebsitePublicKey.

CapsolverGeeTestV3Challenge dataclass

Bases: GeeTestV3Challenge

GeeTest v3 with optional API-server subdomain.

CapsolverGeeTestV4Challenge dataclass

Bases: GeeTestV4Challenge

GeeTest v4 — supported by current Capsolver docs (captchaId + riskType top-level; the ADR-0076 exclusion was SDK-stale).

CapsolverHCaptchaChallenge dataclass

Bases: HCaptchaChallenge

hCaptcha. rqdata rides the wire rqdata field; enterprise is a separate task type. (Capsolver's docs nav omits hCaptcha — mapping follows the SDK + spec.)

CapsolverImageChallenge dataclass

Bases: ImageChallenge

OCR image task. Returns its result inline (instant, ADR-0075); proxyless — recognition tasks take no proxy.

CapsolverRecaptchaV2Challenge dataclass

Bases: RecaptchaV2Challenge

reCAPTCHA v2. action maps to Capsolver's pageAction (the sa payload value). Enterprise is a separate task type.

CapsolverRecaptchaV3Challenge dataclass

Bases: RecaptchaV3Challenge

reCAPTCHA v3. Proxyless-only; Capsolver exposes no v3-enterprise task type, so is_enterprise is rejected.

CapsolverTurnstileChallenge dataclass

Bases: TurnstileChallenge

Cloudflare Turnstile. Capsolver uses the fixed proxyless AntiTurnstileTaskProxyLess and ignores userAgent; only action/c_data are supported (chl_page_data is not serialized).

AsyncCapsolverClient

Asyncio-native facade over the Capsolver JSON API.

CapsolverClient

Blocking facade over the Capsolver JSON API.

CapsolverFunCaptchaSolution dataclass

Bases: FunCaptchaSolution

Solved Arkose Labs FunCaptcha token.

CapsolverGeeTestV3Solution dataclass

Bases: GeeTestV3Solution

Solved GeeTest v3 three-part answer.

CapsolverGeeTestV4Solution dataclass

Bases: GeeTestV4Solution

Solved GeeTest v4 five-part answer.

CapsolverHCaptchaSolution dataclass

Bases: HCaptchaSolution

Solved hCaptcha token.

CapsolverImageSolution dataclass

Bases: ImageSolution

Solved image captcha text.

CapsolverRecaptchaV2Solution dataclass

Bases: RecaptchaV2Solution

Solved reCAPTCHA v2 token.

CapsolverRecaptchaV3Solution dataclass

Bases: RecaptchaV3Solution

Solved reCAPTCHA v3 token.

CapsolverTurnstileSolution dataclass

Bases: TurnstileSolution

Solved Cloudflare Turnstile token.