using ImagesToText;

    /* Put your ImagesToText account username and password here.
       Use HttpClient for HTTP API. */
    Client client = (Client)new SocketClient(username, password);
    try {
        double balance = client.GetBalance();

        /* Put your CAPTCHA file name, or file object, or arbitrary stream,
           or an array of bytes, and optional solving timeout (in seconds) here: */
        Captcha captcha = client.Decode(captchaFileName, timeout);
        if (null != captcha) {
            /* The CAPTCHA was solved; captcha.Id property holds its numeric ID,
               and captcha.Text holds its text. */
            Console.WriteLine("CAPTCHA {0} solved: {1}", captcha.Id, captcha.Text);

            if (/* check if the CAPTCHA was incorrectly solved */) {
                client.Report(captcha);
            }
        }
    } catch (AccessDeniedException e) {
        /* Access to ITT API denied, check your credentials and/or balance */
    }

    import com.ImagesToText.AccessDeniedException;
    import com.ImagesToText.Captcha;
    import com.ImagesToText.Client;
    import com.ImagesToText.SocketClient;
    import com.ImagesToText.HttpClient;

    /* Put your ImagesToText account username and password here.
       Use HttpClient for HTTP API. */
    Client client = (Client)new SocketClient(username, password);
    try {
        double balance = client.getBalance();

        /* Put your CAPTCHA file name, or file object, or arbitrary input stream,
           or an array of bytes, and optional solving timeout (in seconds) here: */
        Captcha captcha = client.decode(captchaFileName, timeout);
        if (null != captcha) {
            /* The CAPTCHA was solved; captcha.id property holds its numeric ID,
               and captcha.text holds its text. */
            System.out.println("CAPTCHA " + captcha.id + " solved: " + captcha.text);

            if (/* check if the CAPTCHA was incorrectly solved */) {
                client.report(captcha);
            }
        }
    } catch (AccessDeniedException e) {
        /* Access to ITT API denied, check your credentials and/or balance */
    }

    require_once "imagestotext.php";

    /* Put your ITT account username and password here.
       Use ImagesToText_HttpClient for HTTP API. */
    $client = new ImagesToText_SocketClient($username, $password);
    try {
        $balance = $client->get_balance();

        /* Put your CAPTCHA file name or opened file handler, and optional
           solving timeout (in seconds) here: */
        $captcha = $client->decode($captcha_file_name, $timeout);
        if ($captcha) {
            /* The CAPTCHA was solved; captcha["captcha"] item holds its
               numeric ID, and captcha["text"] item its text. */
            echo "CAPTCHA {$captcha["captcha"]} solved: {$captcha["text"]}";

            if (/* check if the CAPTCHA was incorrectly solved */) {
                $client->report($captcha["captcha"]);
            }
        }
    } catch (ImagesToText_AccessDeniedException) {
        /* Access to ITT API denied, check your credentials and/or balance */
    }

    import imagestotext

    # Put your ITT account username and password here.
    # Use imagestotext.HttpClient for HTTP API.
    client = imagestotext.SocketClient(username, password)
    try:
        balance = client.get_balance()

        # Put your CAPTCHA file name or file-like object, and optional
        # solving timeout (in seconds) here:
        captcha = client.decode(captcha_file_name, timeout)
        if captcha:
            # The CAPTCHA was solved; captcha["captcha"] item holds its
            # numeric ID, and captcha["text"] item its text.
            print "CAPTCHA %s solved: %s" % (captcha["captcha"], captcha["text"])

            if ...:  # check if the CAPTCHA was incorrectly solved
                client.report(captcha["captcha"])
    except imagestotext.AccessDeniedException:
        # Access to ITT API denied, check your credentials and/or balance

New Recaptcha API support

What's "new reCAPTCHA/noCAPTCHA"?

They're new reCAPTCHA challenges that typically require the user to identify and click on certain images. They're not to be confused with traditional word/number reCAPTCHAs (those have no images).

For your convinience, we implemented support for New Recaptcha API. If your software works with it, and supports minimal configuration, you should be able to decode captchas using New Recaptcha API in no time.

We provide two different types of New Recaptcha API:

• Coordinates API: Provided a screenshot, the API returns a group of coordinates to click.
• Image Group API: Provided a group of (base64-encoded) images, the API returns the indexes of the images to click.

Coordinates API FAQ:

What's the Coordinates API URL?

To use the Coordinates API you will have to send a HTTP POST Request to http://api.imagestotext.com/api/captcha

What are the POST parameters for the Coordinates API?

• username: Your ITT account username
• password: Your ITT account password
• captchafile: a Base64 encoded or Multipart file contents with a valid New Recaptcha screenshot
• type=2: Type 2 specifies this is a New Recaptcha Coordinates API

What's the response from the Coordinates API?

captcha: id of the provided captcha, if the text field is null, you will have to pool the url http://api.imagestotext.com/api/captcha/captcha_id until it becomes available

is_correct:(0 or 1) specifying if the captcha was marked as incorrect or unreadable

text: a json-like nested list, with all the coordinates (x, y) to click relative to the image, for example:

              [[23.21, 82.11]]
          

where the X coordinate is 23.21 and the Y coordinate is 82.11

Image Group API FAQ:

What's the Image Group API URL?

To use the Image Group API you will have to send a HTTP POST Request to http://api.imagestotext.com/api/captcha

What are the POST parameters for the Image Group API?

• username: Your ITT account username
• password: Your ITT account password
• captchafile: the Base64 encoded file contents with a valid New Recaptcha screenshot. You must send each image in a single "captchafile" parameter. The order you send them matters
• banner: the Base64 encoded banner image (the example image that appears on the upper right)
• banner_text: the banner text (the text that appears on the upper left)
• type=3: Type 3 specifies this is a New Recaptcha Image Group API
• grid: Optional grid parameter specifies what grid individual images in captcha are aligned to (string, width+"x"+height, Ex.: "2x4", if images aligned to 4 rows with 2 images in each. If not supplied, ITT will attempt to autodetect the grid.

What's the response from the Image Group API?

captcha: id of the provided captcha, if the text field is null, you will have to pool the url http://api.imagestotext.com/api/captcha/captcha_id until it becomes available

is_correct:(0 or 1) specifying if the captcha was marked as incorrect or unreadable

text: a json-like list of the index for each image that should be clicked. for example:

              [1, 4, 6]
          

where the images that should be clicked are the first, the fourth and the six, counting from left to right and up to bottom

Examples

Python and Recaptcha Coordinates API

                  import imagestotext

                  # Put your ITT account username and password here.
                  username = "user"  
                  password = "password"
                  captcha_file = 'test.jpg' # image

                  client = imagestotext.SocketClient(username, password) 
                  # to use http client use: client = imagestotext.HttpClient(username, password)


                  try:
                      balance = client.get_balance()

                      # Put your CAPTCHA file name or file-like object, and optional
                      # solving timeout (in seconds) here:
                      captcha = client.decode(captcha_file, type=2)
                      if captcha:
                          # The CAPTCHA was solved; captcha["captcha"] item holds its
                          # numeric ID, and captcha["text"] item its list of "coordinates".
                          print "CAPTCHA %s solved: %s" % (captcha["captcha"], captcha["text"])

                          if '':  # check if the CAPTCHA was incorrectly solved
                              client.report(captcha["captcha"])
                  except imagestotext.AccessDeniedException:
                      # Access to ITT API denied, check your credentials and/or balance
                      print "error: Access to ITT API denied, check your credentials and/or balance"
              

Python and Recaptcha Image Group

                  import imagestotext

                  # Put your ITT account username and password here.
                  username = "user"  
                  password = "password"
                  captcha_file = "test2.jpg"  # image
                  banner = "banner.jpg"  # image banner
                  banner_text = "select all pizza:"

                  #client = imagestotext.SocketClient(username, password) 
                  client = imagestotext.HttpClient(username, password)
                  # to use http client use: client = imagestotext.HttpClient(username, password)


                  try:
                      balance = client.get_balance()

                      # Put your CAPTCHA file name or file-like object, and optional
                      # solving timeout (in seconds) here:
                      captcha = client.decode(
                          captcha_file, type=3, banner=banner, banner_text=banner_text)
                      #you can supply optional `grid` argument to decode() call, with a 
                      #string like 3x3 or 2x4, defining what grid individual images were located at
                      #example: 
                      #captcha = client.decode(
                      #    captcha_file, type=3, banner=banner, banner_text=banner_text, grid="2x4")
                      #see 2x4.png example image to have an idea what that images look like
                      #If you wont supply `grid` argument, ITT will attempt to autodetect the grid
                      if captcha:
                          # The CAPTCHA was solved; captcha["captcha"] item holds its
                          # numeric ID, and captcha["text"] is a json-like list of the index for each image that should be clicked.
                          print "CAPTCHA %s solved: %s" % (captcha["captcha"], captcha["text"])

                          if '':  # check if the CAPTCHA was incorrectly solved
                              client.report(captcha["captcha"])
                  except imagestotext.AccessDeniedException:
                      # Access to ITT API denied, check your credentials and/or balance
                      print "error: Access to ITT API denied, check your credentials and/or balance"
              

PHP and Recaptcha Coordinates API

                  /**
                   * Images To Text PHP API recaptcha coordinates usage example
                   *
                   * @package ITTAPI
                   * @subpackage PHP
                   */

                  /**
                   * ITT API clients
                   */
                  require_once 'imagestotext.php';

                  // Put your ITT username & password here.
                  $username = "username";
                  $password = "password";
                  $captcha_filename = "test.jpg";  # your captchafile
                  $extra = ['type'=>2];   # extra parameters in an array
                  // Use ImagesToText_HttpClient() class if you want to use HTTP API.
                  $client = new ImagesToText_SocketClient($username, $password);
                  $client->is_verbose = true;

                  echo "Your balance is {$client->balance} US cents\n";

                  // Put your CAPTCHA image file name, file resource, or vector of bytes,
                  // and optional solving timeout (in seconds) here; you'll get CAPTCHA
                  // details array on success.
                  if ($captcha = $client->decode($captcha_filename, $extra)) {
                      echo "CAPTCHA {$captcha['captcha']} uploaded\n";

                      sleep(ImagesToText_Client::DEFAULT_TIMEOUT);

                          // Poll for CAPTCHA coordinates:
                          if ($text = $client->get_text($captcha['captcha'])) {
                              echo "CAPTCHA {$captcha['captcha']} solved: {$text}\n";

                              // Report an incorrectly solved CAPTCHA.
                              // Make sure the CAPTCHA was in fact incorrectly solved!
                              //$client->report($captcha['captcha']);
                          }
                      }
              

PHP and Recaptcha Image Group

                  /**
                   * Images To Text PHP API recaptcha coordinates usage example
                   *
                   * @package ITTAPI
                   * @subpackage PHP
                   */

                  /**
                   * ITT API clients
                   */
                  require_once 'imagestotext.php';

                  // Put your ITT username & password here.
                  $username = "username";
                  $password = "password";
                  $captcha_filename = "test2.jpg";   # your captchafile
                  // extra parameters in an array
                  $extra = [
                      'type'=>3,
                      'banner'=> 'banner.jpg',  # banner img
                      'banner_text'=> "select all pizza:"  # banner text 
                       #'grid' => "3x2" #optional paramater for specifying what grid 
                                        #images are aligned to. 
                                        #If ommitted, ITT would try to autodetect the grid.
                  ];
                  // Use ImagesToText_HttpClient() class if you want to use HTTP API.
                  $client = new ImagesToText_SocketClient($username, $password);
                  $client->is_verbose = true;

                  echo "Your balance is {$client->balance} US cents\n";

                  if ($captcha = $client->decode($captcha_filename, $extra)) {
                      echo "CAPTCHA {$captcha['captcha']} uploaded\n";

                      sleep(ImagesToText_Client::DEFAULT_TIMEOUT);

                          // Poll for CAPTCHA indexes:
                          if ($text = $client->get_text($captcha['captcha'])) {
                              echo "CAPTCHA {$captcha['captcha']} solved: {$text}\n";

                              // Report an incorrectly solved CAPTCHA.
                              // Make sure the CAPTCHA was in fact incorrectly solved!
                              //$client->report($captcha['captcha']);
                          }
                      }