ImageCaptcha¶

To import this module:

from python_rucaptcha.image_captcha import ImageCaptcha

class python_rucaptcha.image_captcha.ImageCaptcha(save_format: str | SaveFormatsEnm = SaveFormatsEnm.TEMP, img_clearing: bool = True, img_path: str = 'PythonRuCaptchaImages', *args, **kwargs)¶

__init__(save_format: str | SaveFormatsEnm = SaveFormatsEnm.TEMP, img_clearing: bool = True, img_path: str = 'PythonRuCaptchaImages', *args, **kwargs)¶

The class is used to work with Image Captcha.

Parameters:

rucaptcha_key – User API key
save_format (str | SaveFormatsEnm) – The format in which the image will be saved, or as a temporary file - ‘temp’, or as a regular image to a folder created by the library - ‘const’.
img_clearing (bool) – True - delete file after solution, False - don’t delete file after solution
img_path (str) – Folder to save captcha images
kwargs – Additional not required params for this captcha type

Examples

>>> ImageCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
...             ).captcha_handler(captcha_link="https://rucaptcha.com/dist/web/99581b9d446a509a0a01954438a5e36a.jpg")
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

>>> ImageCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
...             ).captcha_handler(captcha_file="src/examples/088636.png")
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

>>> with open("src/examples/088636.png", "rb") as f:
...     file_data = f.read()
>>> ImageCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122"
...             ).captcha_handler(captcha_base64=file_data)
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

>>> await ImageCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
...             ).aio_captcha_handler(captcha_link="https://rucaptcha.com/dist/web/99581b9d446a509a0a01954438a5e36a.jpg")
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

>>> await ImageCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
...             ).aio_captcha_handler(captcha_file="src/examples/088636.png")
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

Death Captcha

>>> ImageCaptcha(rucaptcha_key="some_username:some_password",
...             service_type="deathbycaptcha"
...             ).captcha_handler(captcha_file="src/examples/088636.jpg")
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

>>> await ImageCaptcha(rucaptcha_key="some_username:some_password",
...             service_type="deathbycaptcha"
...             ).aio_captcha_handler(captcha_link="https://rucaptcha.com/dist/web/99581b9d446a509a0a01954438a5e36a.jpg")
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

>>> with open("src/examples/088636.png", "rb") as f:
...     file_data = f.read()
>>> await ImageCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122"
...             ).aio_captcha_handler(captcha_base64=file_data)
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "text":"w9h5k"
   },
   "cost":0.033,
   "ip":"46.53.241.91",
   "createTime":1696730723,
   "endTime":1696730723,
   "solveCount":1,
   "taskId":74708110322
}

Returns:: Dict with full server response

Notes

https://2captcha.com/api-docs/normal-captcha

https://rucaptcha.com/api-docs/normal-captcha

captcha_handler(captcha_link: str | None = None, captcha_file: str | None = None, captcha_base64: bytes | None = None, **kwargs) → dict¶

Sync solving method

Parameters:

captcha_link (str | None) – Captcha image URL
captcha_file (str | None) – Captcha image file path
captcha_base64 (bytes | None) – Captcha image BASE64 info
kwargs – additional params for requests library

Returns:

Dict with full server response

Return type:

dict

Notes

Check class docstirng for more info

async aio_captcha_handler(captcha_link: str | None = None, captcha_file: str | None = None, captcha_base64: bytes | None = None, **kwargs) → dict¶

Async solving method

Parameters:

captcha_link (str | None) – Captcha image URL
captcha_file (str | None) – Captcha image file path
captcha_base64 (bytes | None) – Captcha image BASE64 info
kwargs – additional params for aiohttp library

Returns:

Dict with full server response

Return type:

dict

Notes

Check class docstirng for more info

ImageCaptcha¶

Contents

Navigation