python3-capsolver 0.9.2__tar.gz → 1.0.0a0__tar.gz

python3_capsolver-1.0.0a0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Andrei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python3_capsolver-1.0.0a0/MANIFEST.in

@@ -0,0 +1 @@
+include README.md LICENSE

{python3-capsolver-0.9.2 → python3_capsolver-1.0.0a0}/PKG-INFO

@@ -1,34 +1,15 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: python3-capsolver
-Version: 0.9.2
+Version: 1.0.0a0
 Summary: Python 3.8+ Capsolver library with AIO module.
-Home-page: https://andreidrang.github.io/python3-capsolver/
-Author: AndreiDrang
-Author-email: python-captcha@pm.me
-License: MIT
+Author-email: AndreiDrang <python-captcha@pm.me>
+License: MIT License
+Project-URL: Homepage, https://andreidrang.github.io/python3-capsolver/
 Project-URL: Documentation, https://andreidrang.github.io/python3-capsolver/
-Project-URL: Source, https://github.com/AndreiDrang/python3-capsolver
-Keywords: captcha 
-                recaptcha
-                geetest
-                hcaptcha
-                capypuzzle
-                rotatecaptcha
-                funcaptcha
-                keycaptcha
-                python3
-                python-library
-                capsolver
-                datadomeslider
-                datadome
-                mtcaptcha
-				turnstile
-				cloudflare
-				amazon
-				amazon_waf
-				akamai
-				imperva
-				binance
+Project-URL: Repository, https://github.com/AndreiDrang/python3-capsolver
+Project-URL: Issues, https://github.com/AndreiDrang/python3-capsolver/issues
+Project-URL: Changelog, https://github.com/AndreiDrang/python3-capsolver/releases
+Keywords: captcha,recaptcha,geetest,hcaptcha,capypuzzle,rotatecaptcha,funcaptcha,keycaptcha,python3,python-library,capsolver,datadomeslider,datadome,mtcaptcha,turnstile,cloudflare,amazon,amazon_waf,akamai,imperva,binance
 Classifier: License :: OSI Approved :: MIT License
 Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
 Classifier: Development Status :: 5 - Production/Stable
@@ -39,30 +20,30 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Framework :: AsyncIO
 Classifier: Operating System :: Unix
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: MacOS
-Requires-Python: >=3.8.0
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-
+License-File: LICENSE
+Requires-Dist: requests>=2.21.0
+Requires-Dist: aiohttp>=3.9.2
+Requires-Dist: msgspec<0.20,>=0.18
+Requires-Dist: tenacity<10,>=8
 
 # python3-capsolver
 
-![Logo](https://red-panda-dev.xyz/media/images/Capsolver.max-800x600.png)
+[![Capsolver.png](https://s.vyjava.xyz/files/2024/12-December/17/109278aa/Capsolver.png)](https://vyjava.xyz/dashboard/image/109278aa-961a-4503-bed0-0a9c838dcef2)
 
-<a href="https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1">
-    <img src="https://cdn.discordapp.com/attachments/1105172394655625306/1105180101802471575/20221207-160749.gif" alt="Capsolver's Banner">
-</a>
-<br>
-At the lowest price on the market, you may receive a variety of solutions, including reCAPTCHA V2, reCAPTCHA V3, hCaptcha, hCaptcha Click, FunCaptcha, picture-to-text, and more. With this service, 0.1s is the slowest speed ever measured.
 <hr>
 
 [![PyPI version](https://badge.fury.io/py/python3-capsolver.svg)](https://badge.fury.io/py/python3-capsolver)
 [![Python versions](https://img.shields.io/pypi/pyversions/python3-capsolver.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python3-capsolver)
 [![Downloads](https://static.pepy.tech/badge/python3-capsolver/month)](https://pepy.tech/project/python3-capsolver)
+[![Static Badge](https://img.shields.io/badge/docs-Sphinx-green?label=Documentation&labelColor=gray)](https://andreidrang.github.io/python3-capsolver/)
 
-[![Maintainability](https://api.codeclimate.com/v1/badges/3c30167b5fb37a0775ea/maintainability)](https://codeclimate.com/github/AndreiDrang/python3-capsolver/maintainability)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/323d4eda0fe1477bbea8fe8902b9e97e)](https://www.codacy.com/gh/AndreiDrang/python3-capsolver/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=AndreiDrang/python3-capsolver&amp;utm_campaign=Badge_Grade)
 [![codecov](https://codecov.io/gh/AndreiDrang/python3-capsolver/branch/main/graph/badge.svg?token=2L4VVIF4G8)](https://codecov.io/gh/AndreiDrang/python3-capsolver)
 
@@ -74,23 +55,10 @@ At the lowest price on the market, you may receive a variety of solutions, inclu
 
 
 Python 3 library for [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
-
 Tested on UNIX based OS.
 
 The library is intended for software developers and is used to work with the [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
 
-***
-
-If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
-
-Or email python-captcha@pm.me
-
-***
-
-You can check our other projects here - [RedPandaDev group](https://red-panda-dev.xyz/blog/). For example - [Torrents Tracker bot](https://t.me/torrents_tracker_bot) for Telegram.
-
-***
-
 ## How to install?
 
 We recommend using the latest version of Python. `python3-capsolver` supports Python 3.7+.
@@ -118,4 +86,10 @@ Check [releases page](https://github.com/AndreiDrang/python3-capsolver/releases)
 
 ### How to get API Key to work with the library
 1. On the page - https://dashboard.capsolver.com/overview/user-center
-2. Find it: ![img.png](files/img.png)
+2. Find it: [![img.png](https://s.vyjava.xyz/files/2024/12-December/17/ae8d4fbf/img.png)](https://vyjava.xyz/dashboard/image/ae8d4fbf-7451-441d-8984-79b1a7adbe27)
+
+### Contacts
+
+If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
+
+Or email python-captcha@pm.me

python3_capsolver-1.0.0a0/README.md

@@ -0,0 +1,60 @@
+# python3-capsolver
+
+[![Capsolver.png](https://s.vyjava.xyz/files/2024/12-December/17/109278aa/Capsolver.png)](https://vyjava.xyz/dashboard/image/109278aa-961a-4503-bed0-0a9c838dcef2)
+
+<hr>
+
+[![PyPI version](https://badge.fury.io/py/python3-capsolver.svg)](https://badge.fury.io/py/python3-capsolver)
+[![Python versions](https://img.shields.io/pypi/pyversions/python3-capsolver.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python3-capsolver)
+[![Downloads](https://static.pepy.tech/badge/python3-capsolver/month)](https://pepy.tech/project/python3-capsolver)
+[![Static Badge](https://img.shields.io/badge/docs-Sphinx-green?label=Documentation&labelColor=gray)](https://andreidrang.github.io/python3-capsolver/)
+
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/323d4eda0fe1477bbea8fe8902b9e97e)](https://www.codacy.com/gh/AndreiDrang/python3-capsolver/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=AndreiDrang/python3-capsolver&amp;utm_campaign=Badge_Grade)
+[![codecov](https://codecov.io/gh/AndreiDrang/python3-capsolver/branch/main/graph/badge.svg?token=2L4VVIF4G8)](https://codecov.io/gh/AndreiDrang/python3-capsolver)
+
+[![Sphinx build](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/sphinx.yml/badge.svg?branch=release)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/sphinx.yml)
+[![Build](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/build.yml)
+[![Installation](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/install.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/install.yml)
+[![Tests](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/test.yml)
+[![Lint](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/lint.yml)
+
+
+Python 3 library for [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
+Tested on UNIX based OS.
+
+The library is intended for software developers and is used to work with the [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
+
+## How to install?
+
+We recommend using the latest version of Python. `python3-capsolver` supports Python 3.7+.
+
+### pip
+
+```bash
+pip install python3-capsolver
+```
+
+## How to use?
+
+Is described in the [documentation-website](https://andreidrang.github.io/python3-capsolver/).
+
+
+## How to test?
+
+1. You need set ``API_KEY`` in your environment(get this value from you account).
+2. Run command ``make tests``, from root directory.
+
+
+### Changelog
+
+Check [releases page](https://github.com/AndreiDrang/python3-capsolver/releases).
+
+### How to get API Key to work with the library
+1. On the page - https://dashboard.capsolver.com/overview/user-center
+2. Find it: [![img.png](https://s.vyjava.xyz/files/2024/12-December/17/ae8d4fbf/img.png)](https://vyjava.xyz/dashboard/image/ae8d4fbf-7451-441d-8984-79b1a7adbe27)
+
+### Contacts
+
+If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
+
+Or email python-captcha@pm.me

python3_capsolver-1.0.0a0/pyproject.toml

@@ -0,0 +1,105 @@
+[tool.black]
+line-length = 120
+target-version = ['py310']
+include = '\.pyi?$'
+exclude = '''
+/(
+    \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | _build
+  | buck-out
+  | build
+  | dist
+)/
+'''
+
+[tool.isort]
+profile = "black"
+line_length = 120
+length_sort = true
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+testpaths = [
+    "tests",
+]
+addopts = "-vv --tb=short --durations=10"
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python3-capsolver"
+dynamic = ["version"]
+authors = [
+    {name = "AndreiDrang", email = "python-captcha@pm.me"},
+]
+description = "Python 3.8+ Capsolver library with AIO module."
+readme = "README.md"
+requires-python = ">=3.8"
+keywords = [    "captcha",
+                "recaptcha",
+                "geetest",
+                "hcaptcha",
+                "capypuzzle",
+                "rotatecaptcha",
+                "funcaptcha",
+                "keycaptcha",
+                "python3",
+                "python-library",
+                "capsolver",
+                "datadomeslider",
+                "datadome",
+                "mtcaptcha",
+				"turnstile",
+				"cloudflare",
+				"amazon",
+				"amazon_waf",
+				"akamai",
+				"imperva",
+				"binance"
+            ]
+license = {text = "MIT License"}
+classifiers = [
+        "License :: OSI Approved :: MIT License",
+        "License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)",
+        "Development Status :: 5 - Production/Stable",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Framework :: AsyncIO",
+        "Operating System :: Unix",
+        "Operating System :: Microsoft :: Windows",
+        "Operating System :: MacOS",
+]
+dependencies = [
+    "requests>=2.21.0",
+    "aiohttp>=3.9.2",
+    "msgspec>=0.18,<0.20",
+    "tenacity>=8,<10"
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["python3_capsolver*"]
+
+[tool.setuptools.dynamic]
+version = {attr = "python3_capsolver.__version__"}
+
+[project.urls]
+Homepage = "https://andreidrang.github.io/python3-capsolver/"
+Documentation = "https://andreidrang.github.io/python3-capsolver/"
+Repository = "https://github.com/AndreiDrang/python3-capsolver"
+Issues = "https://github.com/AndreiDrang/python3-capsolver/issues"
+Changelog = "https://github.com/AndreiDrang/python3-capsolver/releases"

python3_capsolver-1.0.0a0/src/python3_capsolver/__init__.py

@@ -0,0 +1 @@
+from python3_capsolver.__version__ import __version__  # noqa

python3_capsolver-1.0.0a0/src/python3_capsolver/__version__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0a"

python3_capsolver-1.0.0a0/src/python3_capsolver/aws_waf.py

@@ -0,0 +1,138 @@
+from typing import Union
+
+from .core.base import CaptchaParams
+from .core.enum import CaptchaTypeEnm
+
+__all__ = ("AwsWaf",)
+
+
+class AwsWaf(CaptchaParams):
+    """
+    The class is used to work with Capsolver AwsWaf methods:
+     - AntiAwsWafTask
+     - AntiAwsWafTaskProxyLess
+     - AwsWafClassification
+
+    Args:
+        api_key: Capsolver API key
+        captcha_type: Captcha type name, like ``AntiAwsWafTask`` and etc.
+        kwargs: additional params for client, like captcha waiting time
+                    available keys:
+                     - sleep_time: int - captcha solution waintig time in sec
+                     - request_url: str - API address for sending requests,
+                                            else official will be used
+
+
+    Examples:
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>>  AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AwsWafClassification
+        ...         ).captcha_handler(task_payload={
+        ...                                 "images": [image],
+        ...                                 "question": "some question",
+        ...                                 "websiteURL": "https://xxxx.com",
+        ...                         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                //carcity point
+                "box": [
+                    116.7,
+                    164.1
+                ],
+                // grid type, objects means the image index that matches the question
+                "objects": [0, 1, 3, 4, 6],
+                //if question include `bifurcatedzoo`
+                "distance": 500
+            }
+        }
+
+
+        >>> import asyncio
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>> asyncio.run(AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AwsWafClassification
+        ...         ).aio_captcha_handler(task_payload={
+        ...                                 "images": [image],
+        ...                                 "question": "some question",
+        ...                                 "websiteURL": "https://xxxx.com",
+        ...                         }))
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                //carcity point
+                "box": [
+                    116.7,
+                    164.1
+                ],
+                // grid type, objects means the image index that matches the question
+                "objects": [0, 1, 3, 4, 6],
+                //if question include `bifurcatedzoo`
+                "distance": 500
+            }
+        }
+
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>>  AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AntiAwsWafTaskProxyLess
+        ...         ).captcha_handler(task_payload={
+        ...                                 "websiteURL": "https://xxxxxx/latest",
+        ...                                 "awsKey": "AQIDAHjcYu/GjX+QlghicBg......shMIKvZswZemrVVqA==",
+        ...                                 "awsChallengeJS": "https://xxxxx/challenge.js",
+        ...                         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                "cookie": "223d1f60-xxxxxxxx"
+            }
+        }
+
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>>  AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AntiAwsWafTask
+        ...         ).captcha_handler(task_payload={
+        ...                                 "websiteURL": "https://xxxxxx/latest",
+        ...                                 "awsKey": "AQIDAHjcYu/GjX+QlghicBg......shMIKvZswZemrVVqA==",
+        ...                                 "awsChallengeJS": "https://xxxxx/challenge.js",
+        ...                                 "proxy": "ip:port:user:pass"
+        ...                         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                "cookie": "223d1f60-xxxxxxxx"
+            }
+        }
+
+    Notes:
+        https://docs.capsolver.com/en/guide/captcha/awsWaf/
+
+        https://docs.capsolver.com/en/guide/recognition/AwsWafClassification/
+    """
+
+    def __init__(self, api_key: str, captcha_type: Union[CaptchaTypeEnm, str], **kwargs):
+
+        super().__init__(api_key=api_key, captcha_type=captcha_type, **kwargs)

python3_capsolver-1.0.0a0/src/python3_capsolver/cloudflare.py

@@ -0,0 +1,95 @@
+from typing import Union
+
+from .core.base import CaptchaParams
+from .core.enum import CaptchaTypeEnm
+
+__all__ = ("Cloudflare",)
+
+
+class Cloudflare(CaptchaParams):
+    """
+    The class is used to work with Capsolver AntiTurnstileTaskProxyLess captcha solving method
+
+    Args:
+        api_key: Capsolver API key
+        captcha_type: Captcha type name, like ``AntiTurnstileTaskProxyLess`` and etc.
+        kwargs: additional params for client, like captcha waiting time
+                    available keys:
+                     - sleep_time: int - captcha solution waintig time in sec
+                     - request_url: str - API address for sending requests,
+                                            else official will be used
+
+    Examples:
+        >>> from python3_capsolver.cloudflare import Cloudflare
+        >>> from python3_capsolver.core.enum import CaptchaTypeEnm
+        >>> Cloudflare(api_key="CAI-12345....",
+        ...             captcha_type=CaptchaTypeEnm.AntiTurnstileTaskProxyLess)
+        ...         .captcha_handler(task_payload={
+        ...                     "websiteKey": "0x4XXXXXXXXXXXXXXXXX",
+        ...                     "metadata": {
+        ...                         "action": "login",
+        ...                         "cdata": "0000-1111-2222-3333-example-cdata"
+        ...                     }
+        ...         })
+        {
+           "errorId":0,
+           "errorCode":"None",
+           "errorDescription":"None",
+           "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+           "status":"ready",
+           "solution":{
+                "token": "0.mF74FV8wEufAWxxxx",
+                "type": "turnstile",
+                "userAgent": "Mozilla/5.0 xxxx"
+           }
+        }
+
+        >>> from python3_capsolver.cloudflare import Cloudflare
+        >>> from python3_capsolver.core.enum import CaptchaTypeEnm
+        >>> Cloudflare(api_key="CAI-12345....",
+        ...             captcha_type=CaptchaTypeEnm.AntiCloudflareTask)
+        ...         .captcha_handler(task_payload={
+        ...                     "websiteURL": "https://www.yourwebsite.com",
+        ...                     "proxy": "ip:port:user:pass",
+        ...         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                "cookies": "cf_clearance=_VPxxxx",
+                "headers": {
+                    "sec-ch-ua": "\"Chromium\";v=\"130\", \"Google Chrome\";v=\"130\", \"Not?A_Brand\";v=\"99\"",
+                    "sec-ch-ua-platform": "\"Windows\"",
+                    "accept": "text/html,axxxx",
+                    "User-Agent": "Mozilla/5.0xxxx",
+                    "sec-ch-ua-mobile": "?0",
+                    "sec-fetch-user": "?1",
+                    "referer": "https://www.yourwebsite.com",
+                    "Sec-Fetch-Dest": "document",
+                    "Sec-Fetch-Mode": "navigate",
+                    "Sec-Fetch-Site": "same-origin",
+                    "accept-language": "en",
+                },
+                "page_url": "https://www.yourwebsite.com",
+                "proxy": "your proxyxxxx",
+                "token": "_VPCTZXP5bhinxxxx"
+            }
+        }
+
+    Notes:
+        https://docs.capsolver.com/en/guide/captcha/cloudflare_turnstile/
+
+        https://docs.capsolver.com/en/guide/captcha/cloudflare_challenge/
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        captcha_type: Union[CaptchaTypeEnm, str] = CaptchaTypeEnm.AntiTurnstileTaskProxyLess,
+        **kwargs,
+    ):
+
+        super().__init__(api_key=api_key, captcha_type=captcha_type, **kwargs)

python3_capsolver-1.0.0a0/src/python3_capsolver/control.py

@@ -0,0 +1,68 @@
+from .core.base import CaptchaParams
+from .core.enum import CaptchaTypeEnm
+from .core.const import GET_BALANCE_POSTFIX
+from .core.aio_captcha_instrument import AIOCaptchaInstrument
+from .core.sio_captcha_instrument import SIOCaptchaInstrument
+
+__all__ = ("Control",)
+
+
+class Control(CaptchaParams):
+    """
+    The class is used to work with Capsolver control methods.
+
+    Args:
+        api_key: Capsolver API key
+
+    Notes:
+        https://docs.capsolver.com/en/guide/api-getbalance/
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+    ):
+        super().__init__(api_key=api_key, captcha_type=CaptchaTypeEnm.Control)
+
+    def get_balance(self) -> dict:
+        """
+        Synchronous method to view the balance
+
+        Examples:
+            >>> from python3_capsolver.control import Control
+            >>> Control(api_key="CAI-1324...").get_balance()
+            {'balance': 48.6361, 'errorId': 0, 'packages': []}
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstring for more info
+        """
+        self._captcha_handling_instrument = SIOCaptchaInstrument(captcha_params=self)
+        return self._captcha_handling_instrument.send_post_request(
+            session=self._captcha_handling_instrument.session,
+            url_postfix=GET_BALANCE_POSTFIX,
+            payload={"clientKey": self.create_task_payload.clientKey},
+        )
+
+    async def aio_get_balance(self) -> dict:
+        """
+        Asynchronous method to view the balance
+
+        Examples:
+        >>> import asyncio
+        >>> from python3_capsolver.control import Control
+        >>> asyncio.run(Control(api_key="CAI-1324...").aio_get_balance())
+        {'balance': 48.6361, 'errorId': 0, 'packages': []}
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstring for more info
+        """
+        return await AIOCaptchaInstrument.send_post_request(
+            url_postfix=GET_BALANCE_POSTFIX,
+            payload={"clientKey": self.create_task_payload.clientKey},
+        )