Skip to content

🖼️ Image Based#

capmonster_python.ImageToTextTask #

Bases: TaskPayload

Represents a task for solving image-based captcha using certain recognition parameters.

Attributes:

Name Type Description
body str

File body encoded in base64. Ensure it is passed without any line breaks.

capMonsterModule Optional[str]

The name of the recognition module (e.g., "yandex").

recognizingThreshold Optional[int]

The threshold for captcha recognition confidence with a range of 0 to 100. Ensures that you are charged only if recognition confidence meets or exceeds this value.

case Optional[bool]

Indicates whether the captcha is case-sensitive.

numeric Optional[Literal[0, 1]]

Set to 1 if the captcha consists only of numbers.

math Optional[bool]

Set to true if the captcha involves solving a mathematical operation.

capmonster_python.ComplexImageRecaptchaTask #

Bases: TaskPayload

Represents a task payload for solving complex image-based recaptcha challenges.

Attributes:

Name Type Description
imageUrls Optional[List[str]]

Optional list of image URLs associated with the captcha. These may correspond to a single image captcha of formats 4x4, 3x3, or other new configurations.

imagesBase64 Optional[List[str]]

Optional list of base64-encoded images. Similar to imageUrls, these represent segments of the captcha in various formats such as 4x4, 3x3, or others.

metadata ComplexImageRecaptchaMetadata

Metadata describing additional details required for solving the recaptcha challenge. This attribute must be provided.

Raises:

Type Description
CapmonsterValidationException

If neither imageUrls nor imagesBase64 is provided, or if both are provided at the same time.

capmonster_python.ComplexImageRecaptchaMetadata #

Bases: BaseModel

Represents metadata for a complex image-based CAPTCHA task.

Attributes:

Name Type Description
task Optional[str]

Optional. Represents the textual description of the CAPTCHA task (e.g., "Click on traffic lights"). Only one of task or taskDefinition must be set.

taskDefinition Optional[str]

Optional. Represents the technical value defining the CAPTCHA task type. Only one of task or taskDefinition must be set.

grid Literal['4x4', '3x3', '1x1']

Required. Specifies the grid size of the CAPTCHA. It must be one of the possible values: "4x4", "3x3", or "1x1".

capmonster_python.ComplexImageRecognitionTask #

Bases: TaskPayload

Represents a complex image recognition task payload.

Attributes:

Name Type Description
imagesBase64 List[str]

List of base64 encoded images. This is required and contains raw image data in base64 format.

task Literal['oocl_rotate_new', 'oocl_rotate_double_new', 'betpunch_3x3_rotate', 'bls', 'shein']

A string indicating one of the predefined types of recognition task. This must be one of "oocl_rotate_new", "oocl_rotate_double_new", "betpunch_3x3_rotate", "bls", "shein".