Skip to main content

Image Captcha

Solves image-based CAPTCHAs using the AntiCaptcha service.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Image Path - The file path to the image containing the CAPTCHA that needs to be solved.

Options​

  • Timeout - The maximum time (in seconds) to wait for the CAPTCHA to be solved. Default is 30 seconds.
  • Credentials - The AntiCaptcha API token credential used to authenticate with the service.

Output​

  • result - The solved text from the image CAPTCHA.

How It Works​

The Image Captcha node integrates with the AntiCaptcha service to automatically solve image-based CAPTCHAs. When executed, the node:

  1. Validates the provided image path
  2. Encodes the image file as base64
  3. Creates an ImageToTextTask on the AntiCaptcha service
  4. Continuously checks the task status until it's completed or times out
  5. Returns the solved text as the result

Requirements​

  • A valid AntiCaptcha account with sufficient balance
  • A local image file containing the CAPTCHA to be solved
  • Read permissions for the specified image file path

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid image file path
  • Unable to read the image file
  • Empty or invalid AntiCaptcha token credential
  • Timeout exceeded while waiting for CAPTCHA solution
  • AntiCaptcha service errors
  • Invalid or corrupted image file

Usage Notes​

  • The AntiCaptcha service charges per solved CAPTCHA, so ensure your account has sufficient balance
  • Supported image formats include JPG, PNG, GIF, and BMP
  • The image should contain only the CAPTCHA text with minimal background noise for best results
  • The default timeout is 30 seconds, but this can be adjusted based on the complexity of the CAPTCHA
  • The image file must be accessible from the robot's file system
  • For optimal results, use high-resolution images with clear, readable text

Image Requirements​

For best solving accuracy, the image should:

  • Contain only the CAPTCHA text
  • Have high contrast between text and background
  • Be free from excessive noise or distortion
  • Not be too small (minimum recommended size is 200x50 pixels)
  • Not contain multiple lines of text or complex layouts