captcha-solver-api 1.0.1__tar.gz → 1.0.2__tar.gz

{captcha_solver_api-1.0.1 → captcha_solver_api-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: captcha-solver-api
-Version: 1.0.1
+Version: 1.0.2
 Summary: Official Python SDK for solving reCAPTCHA v2/v3, Cloudflare Turnstile, GeeTest v3/v4, Yandex SmartCaptcha, Tencent, and image/click captchas via the Captcha Solver API
 Author: Captcha Solver Team
 License-Expression: MIT
@@ -157,7 +157,7 @@ Constructor.
 | `client_key` | `str` | required | Your Captcha Solver API key. Raises `ValidationError` if empty. |
 | `base_url` | `str` | `https://api.captcha-solver.com` | API base URL. Override only for self-hosted/staging deployments. |
 | `timeout` | `int` | `120` | Polling window after task creation, in seconds. Overridable per call; each HTTP request has a separate 30-second timeout. |
-| `polling_interval` | `int` | `10` | Seconds before the first `getTaskResult` poll and between subsequent polls, matching the official 2Captcha Python SDK. |
+| `polling_interval` | `int` | `10` | Seconds before the first `getTaskResult` poll and between subsequent polls. |
 | `language_pool` | `Optional[str]` | `None` | Default worker pool (`"en"` or `"ru"`) applied to every call that doesn't pass its own `language_pool`. |
 
 Both clients hold a reusable connection pool (`requests.Session` / `httpx.AsyncClient`)
@@ -476,7 +476,7 @@ for the widget on the target page. Use the coordinates method for image challeng
 
 `YandexSmartCaptchaTaskProxyless` / `YandexSmartCaptchaTask` -- token-based
 challenge. For the image challenge instead, use `CoordinatesTask` with
-`imgType="smart_captcha"` (see [Coordinates](#coordinates-click-captcha) below).
+[Coordinates](#coordinates-click-captcha) is available for generic click captchas.
 
 | Parameter | Required | Description |
 |---|---|---|
@@ -519,10 +519,9 @@ SmartCaptcha's image challenge. No proxy variant -- the image is submitted direc
 |---|---|---|
 | `body` | yes | The captcha image, base64-encoded. |
 | `comment` | no (recommended) | Hint for the worker, e.g. `"click on the green apple"`. |
-| `imgInstructions` | required for `imgType="smart_captcha"` | Instruction image, base64-encoded, showing what to click and in what order. |
+| `imgInstructions` | no | Optional instruction image, base64-encoded. |
 | `minClicks` | no | Minimum number of clicks expected (default `1`). |
 | `maxClicks` | no | Maximum number of clicks allowed. |
-| `imgType` | no | `"smart_captcha"` to solve a Yandex SmartCaptcha image challenge instead of a generic click captcha. |
 
 **Response:** `coordinates` -- a list of `{"x": int, "y": int}` pixel positions to click, in order.
 
@@ -540,9 +539,6 @@ task = CoordinatesTask(
 result = client.solve(task)
 print(result["coordinates"])  # [{"x": 140, "y": 110}]
 ```
-For the Yandex SmartCaptcha image challenge, see
-[examples/sync/yandex_smartcaptcha_image.py](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/sync/yandex_smartcaptcha_image.py)
-(or [examples/async](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/async/yandex_smartcaptcha_image.py)).
 
 ### Tencent
 
@@ -604,8 +600,8 @@ result = client.solve(task, timeout=300)
 ```
 
 The [API requires at least 5 seconds between polls](https://captcha-solver.com/en/docs/how-it-works).
-The SDK defaults to 10 seconds, like the official 2Captcha Python SDK. `solve()`
-waits for `polling_interval` before its first poll and between polls.
+The SDK defaults to 10 seconds. `solve()` waits for `polling_interval` before
+its first poll and between polls.
 Its default 120-second polling window is independent of the API's five-minute
 task lifetime. A local timeout does not cancel a task or mean that the API
 failed to solve it. Use `create_task()` and keep its `task_id` if you need to
@@ -695,8 +691,7 @@ Avoid importing it by name: it shadows Python's built-in `TimeoutError`.
 See the dedicated [examples documentation](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/README.md) for the full
 sync/async example list, setup steps, expected results, and placeholder guidance.
 
-- **Image/click captchas** (`image_to_text.py`, `coordinates.py`,
-  `yandex_smartcaptcha_image.py`) run after installing the dependencies and setting a valid
+- **Image/click captchas** (`image_to_text.py`, `coordinates.py`) run after installing the dependencies and setting a valid
   `CAPTCHA_API_KEY` -- they read sample images bundled in
   [examples/assets](https://github.com/captcha-solver-api/python-sdk/tree/main/examples/assets), no target page needed.
   `python-dotenv` is optional: install it only if you want the scripts to load a `.env` file.

{captcha_solver_api-1.0.1 → captcha_solver_api-1.0.2}/README.md

@@ -121,7 +121,7 @@ Constructor.
 | `client_key` | `str` | required | Your Captcha Solver API key. Raises `ValidationError` if empty. |
 | `base_url` | `str` | `https://api.captcha-solver.com` | API base URL. Override only for self-hosted/staging deployments. |
 | `timeout` | `int` | `120` | Polling window after task creation, in seconds. Overridable per call; each HTTP request has a separate 30-second timeout. |
-| `polling_interval` | `int` | `10` | Seconds before the first `getTaskResult` poll and between subsequent polls, matching the official 2Captcha Python SDK. |
+| `polling_interval` | `int` | `10` | Seconds before the first `getTaskResult` poll and between subsequent polls. |
 | `language_pool` | `Optional[str]` | `None` | Default worker pool (`"en"` or `"ru"`) applied to every call that doesn't pass its own `language_pool`. |
 
 Both clients hold a reusable connection pool (`requests.Session` / `httpx.AsyncClient`)
@@ -440,7 +440,7 @@ for the widget on the target page. Use the coordinates method for image challeng
 
 `YandexSmartCaptchaTaskProxyless` / `YandexSmartCaptchaTask` -- token-based
 challenge. For the image challenge instead, use `CoordinatesTask` with
-`imgType="smart_captcha"` (see [Coordinates](#coordinates-click-captcha) below).
+[Coordinates](#coordinates-click-captcha) is available for generic click captchas.
 
 | Parameter | Required | Description |
 |---|---|---|
@@ -483,10 +483,9 @@ SmartCaptcha's image challenge. No proxy variant -- the image is submitted direc
 |---|---|---|
 | `body` | yes | The captcha image, base64-encoded. |
 | `comment` | no (recommended) | Hint for the worker, e.g. `"click on the green apple"`. |
-| `imgInstructions` | required for `imgType="smart_captcha"` | Instruction image, base64-encoded, showing what to click and in what order. |
+| `imgInstructions` | no | Optional instruction image, base64-encoded. |
 | `minClicks` | no | Minimum number of clicks expected (default `1`). |
 | `maxClicks` | no | Maximum number of clicks allowed. |
-| `imgType` | no | `"smart_captcha"` to solve a Yandex SmartCaptcha image challenge instead of a generic click captcha. |
 
 **Response:** `coordinates` -- a list of `{"x": int, "y": int}` pixel positions to click, in order.
 
@@ -504,9 +503,6 @@ task = CoordinatesTask(
 result = client.solve(task)
 print(result["coordinates"])  # [{"x": 140, "y": 110}]
 ```
-For the Yandex SmartCaptcha image challenge, see
-[examples/sync/yandex_smartcaptcha_image.py](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/sync/yandex_smartcaptcha_image.py)
-(or [examples/async](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/async/yandex_smartcaptcha_image.py)).
 
 ### Tencent
 
@@ -568,8 +564,8 @@ result = client.solve(task, timeout=300)
 ```
 
 The [API requires at least 5 seconds between polls](https://captcha-solver.com/en/docs/how-it-works).
-The SDK defaults to 10 seconds, like the official 2Captcha Python SDK. `solve()`
-waits for `polling_interval` before its first poll and between polls.
+The SDK defaults to 10 seconds. `solve()` waits for `polling_interval` before
+its first poll and between polls.
 Its default 120-second polling window is independent of the API's five-minute
 task lifetime. A local timeout does not cancel a task or mean that the API
 failed to solve it. Use `create_task()` and keep its `task_id` if you need to
@@ -659,8 +655,7 @@ Avoid importing it by name: it shadows Python's built-in `TimeoutError`.
 See the dedicated [examples documentation](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/README.md) for the full
 sync/async example list, setup steps, expected results, and placeholder guidance.
 
-- **Image/click captchas** (`image_to_text.py`, `coordinates.py`,
-  `yandex_smartcaptcha_image.py`) run after installing the dependencies and setting a valid
+- **Image/click captchas** (`image_to_text.py`, `coordinates.py`) run after installing the dependencies and setting a valid
   `CAPTCHA_API_KEY` -- they read sample images bundled in
   [examples/assets](https://github.com/captcha-solver-api/python-sdk/tree/main/examples/assets), no target page needed.
   `python-dotenv` is optional: install it only if you want the scripts to load a `.env` file.

captcha_solver_api-1.0.2/captcha_solver_api/_version.py

@@ -0,0 +1 @@
+__version__ = "1.0.2"

{captcha_solver_api-1.0.1 → captcha_solver_api-1.0.2}/captcha_solver_api/async_client.py

@@ -54,7 +54,7 @@ class AsyncCaptchaClient:
                 raising `CaptchaTimeoutError`. Can be overridden per call.
             polling_interval: Seconds to wait before the first `getTaskResult`
                 poll and between subsequent polls inside `solve()`. Defaults
-                to 10 seconds, matching the official 2Captcha Python SDK.
+                to 10 seconds.
             language_pool: Default worker pool selector (e.g. `"en"` or `"ru"`)
                 applied to every `create_task()`/`solve()` call that doesn't pass
                 its own `language_pool`. Leave unset to use the account's default

{captcha_solver_api-1.0.1 → captcha_solver_api-1.0.2}/captcha_solver_api/client.py

@@ -43,7 +43,7 @@ class CaptchaClient:
                 raising `CaptchaTimeoutError`. Can be overridden per call.
             polling_interval: Seconds to wait before the first `getTaskResult`
                 poll and between subsequent polls inside `solve()`. Defaults
-                to 10 seconds, matching the official 2Captcha Python SDK.
+                to 10 seconds.
             language_pool: Default worker pool selector (e.g. `"en"` or `"ru"`)
                 applied to every `create_task()`/`solve()` call that doesn't pass
                 its own `language_pool`. Leave unset to use the account's default

{captcha_solver_api-1.0.1 → captcha_solver_api-1.0.2}/captcha_solver_api/tasks.py

@@ -55,6 +55,15 @@ class ProxyMixin:
         proxy_login: Optional[str] = None,
         proxy_password: Optional[str] = None,
     ) -> None:
+        """Sets the proxy fields on this task.
+
+        Args:
+            proxy_type: `"http"`, `"socks4"`, or `"socks5"`.
+            proxy_address: Proxy IP address or hostname.
+            proxy_port: Proxy port.
+            proxy_login: Proxy auth username, if required.
+            proxy_password: Proxy auth password, if required.
+        """
         self.proxyType = proxy_type
         self.proxyAddress = proxy_address
         self.proxyPort = proxy_port
@@ -525,8 +534,7 @@ class GeeTestTask(BaseTask, ProxyMixin):
 
 
 class YandexSmartCaptchaTaskProxyless(BaseTask):
-    """Yandex SmartCaptcha (token challenge) without proxy. For the image
-    challenge instead, use `CoordinatesTask` with `imgType="smart_captcha"`.
+    """Yandex SmartCaptcha (token challenge) without proxy.
 
     Args:
         websiteURL: Full URL of the page where the widget is located.
@@ -597,20 +605,16 @@ class YandexSmartCaptchaTask(BaseTask, ProxyMixin):
 
 
 class CoordinatesTask(BaseTask):
-    """Coordinate-based (click) image captcha. Used both for generic
-    "click on X" captchas and for Yandex SmartCaptcha's image challenge (set
-    `imgType` accordingly). No proxy variant -- the image is submitted directly.
+    """Coordinate-based (click) image captcha. No proxy variant -- the image
+    is submitted directly.
 
     Args:
         body: The captcha image, base64-encoded (no `data:image/...;base64,` prefix).
         comment: Hint for the worker, e.g. `"click on the green apple"`. Recommended
             for generic click captchas.
-        imgInstructions: Optional instruction image, base64-encoded, showing what
-            to click and in what order. Required when `imgType="smart_captcha"`.
+        imgInstructions: Optional instruction image, base64-encoded.
         minClicks: Minimum number of clicks expected (default `1`).
         maxClicks: Maximum number of clicks allowed.
-        imgType: Set to `"smart_captcha"` to solve a Yandex SmartCaptcha image
-            challenge instead of a generic click captcha.
 
     Returns (`solution` from `solve()`):
         `coordinates` -- a list of `{"x": int, "y": int}` pixel positions to click,
@@ -626,14 +630,12 @@ class CoordinatesTask(BaseTask):
         imgInstructions: Optional[str] = None,
         minClicks: Optional[int] = None,
         maxClicks: Optional[int] = None,
-        imgType: Optional[str] = None,
     ) -> None:
         self.body = body
         self.comment = comment
         self.imgInstructions = imgInstructions
         self.minClicks = minClicks
         self.maxClicks = maxClicks
-        self.imgType = imgType
 
 
 class TencentTaskProxyless(BaseTask):

{captcha_solver_api-1.0.1 → captcha_solver_api-1.0.2}/captcha_solver_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: captcha-solver-api
-Version: 1.0.1
+Version: 1.0.2
 Summary: Official Python SDK for solving reCAPTCHA v2/v3, Cloudflare Turnstile, GeeTest v3/v4, Yandex SmartCaptcha, Tencent, and image/click captchas via the Captcha Solver API
 Author: Captcha Solver Team
 License-Expression: MIT
@@ -157,7 +157,7 @@ Constructor.
 | `client_key` | `str` | required | Your Captcha Solver API key. Raises `ValidationError` if empty. |
 | `base_url` | `str` | `https://api.captcha-solver.com` | API base URL. Override only for self-hosted/staging deployments. |
 | `timeout` | `int` | `120` | Polling window after task creation, in seconds. Overridable per call; each HTTP request has a separate 30-second timeout. |
-| `polling_interval` | `int` | `10` | Seconds before the first `getTaskResult` poll and between subsequent polls, matching the official 2Captcha Python SDK. |
+| `polling_interval` | `int` | `10` | Seconds before the first `getTaskResult` poll and between subsequent polls. |
 | `language_pool` | `Optional[str]` | `None` | Default worker pool (`"en"` or `"ru"`) applied to every call that doesn't pass its own `language_pool`. |
 
 Both clients hold a reusable connection pool (`requests.Session` / `httpx.AsyncClient`)
@@ -476,7 +476,7 @@ for the widget on the target page. Use the coordinates method for image challeng
 
 `YandexSmartCaptchaTaskProxyless` / `YandexSmartCaptchaTask` -- token-based
 challenge. For the image challenge instead, use `CoordinatesTask` with
-`imgType="smart_captcha"` (see [Coordinates](#coordinates-click-captcha) below).
+[Coordinates](#coordinates-click-captcha) is available for generic click captchas.
 
 | Parameter | Required | Description |
 |---|---|---|
@@ -519,10 +519,9 @@ SmartCaptcha's image challenge. No proxy variant -- the image is submitted direc
 |---|---|---|
 | `body` | yes | The captcha image, base64-encoded. |
 | `comment` | no (recommended) | Hint for the worker, e.g. `"click on the green apple"`. |
-| `imgInstructions` | required for `imgType="smart_captcha"` | Instruction image, base64-encoded, showing what to click and in what order. |
+| `imgInstructions` | no | Optional instruction image, base64-encoded. |
 | `minClicks` | no | Minimum number of clicks expected (default `1`). |
 | `maxClicks` | no | Maximum number of clicks allowed. |
-| `imgType` | no | `"smart_captcha"` to solve a Yandex SmartCaptcha image challenge instead of a generic click captcha. |
 
 **Response:** `coordinates` -- a list of `{"x": int, "y": int}` pixel positions to click, in order.
 
@@ -540,9 +539,6 @@ task = CoordinatesTask(
 result = client.solve(task)
 print(result["coordinates"])  # [{"x": 140, "y": 110}]
 ```
-For the Yandex SmartCaptcha image challenge, see
-[examples/sync/yandex_smartcaptcha_image.py](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/sync/yandex_smartcaptcha_image.py)
-(or [examples/async](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/async/yandex_smartcaptcha_image.py)).
 
 ### Tencent
 
@@ -604,8 +600,8 @@ result = client.solve(task, timeout=300)
 ```
 
 The [API requires at least 5 seconds between polls](https://captcha-solver.com/en/docs/how-it-works).
-The SDK defaults to 10 seconds, like the official 2Captcha Python SDK. `solve()`
-waits for `polling_interval` before its first poll and between polls.
+The SDK defaults to 10 seconds. `solve()` waits for `polling_interval` before
+its first poll and between polls.
 Its default 120-second polling window is independent of the API's five-minute
 task lifetime. A local timeout does not cancel a task or mean that the API
 failed to solve it. Use `create_task()` and keep its `task_id` if you need to
@@ -695,8 +691,7 @@ Avoid importing it by name: it shadows Python's built-in `TimeoutError`.
 See the dedicated [examples documentation](https://github.com/captcha-solver-api/python-sdk/blob/main/examples/README.md) for the full
 sync/async example list, setup steps, expected results, and placeholder guidance.
 
-- **Image/click captchas** (`image_to_text.py`, `coordinates.py`,
-  `yandex_smartcaptcha_image.py`) run after installing the dependencies and setting a valid
+- **Image/click captchas** (`image_to_text.py`, `coordinates.py`) run after installing the dependencies and setting a valid
   `CAPTCHA_API_KEY` -- they read sample images bundled in
   [examples/assets](https://github.com/captcha-solver-api/python-sdk/tree/main/examples/assets), no target page needed.
   `python-dotenv` is optional: install it only if you want the scripts to load a `.env` file.

captcha_solver_api-1.0.1/captcha_solver_api/_version.py

@@ -1 +0,0 @@
-__version__ = "1.0.1"