Cookie usage notification

This site uses cookies. Cookies remember you, so we can provide you with personalized services. Read our privacy policy.

Logo of «GitHub»
  • We support API for «PHP» language
  • We support API for «Python» language
  • We support API for «Go» language
  • We support API for «Ruby» language
  • We support API for «C#» language
  • We support API for «Java» language
  • We support API for «JavaScript» language

Audio CAPTCHA

Audio

We provide a speech recognition method that allows you to convert an audio record to text. The method can be used to bypass audio captchas or to recognize any audio record.

The limitations are:

  • Max file size: 1 MB
  • Audio duration: not limited
  • Supported audio format: mp3 only
  • Supported speech languages: English, French, German, Greek, Portuguese, Russian

The recognition is fully automated and performed by a neural network trained for speech recognition.

Task type: AudioTask

AudioTask task type specification

Property Type Required Default Description
type String Yes Task type: AudioTask
body String Yes Base64 encoded audio file in mp3 format
lang String Yes en The language of audio record. Supported languages are: en, fr, de, el, pt, ru

Request example

Method: createTask
API endpoint: https://api.2captcha.com/createTask

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "AudioTask",
        "body": "R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==",
        "lang": "en"
    }
}

Response example

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "text": "hello world"
    },
    "cost": "0.0005",
    "ip": "1.2.3.4",
    "createTime": 1692808229,
    "endTime": 1692808326,
    "solveCount": 0
}

Code examples

  // https://github.com/2captcha/2captcha-php

  require(__DIR__ . '/../src/autoloader.php');

  $solver = new \TwoCaptcha\TwoCaptcha('YOUR_API_KEY');

  try {
      $result = $solver->audio('path/to/audio.mp3');
  } catch (\Exception $e) {
      die($e->getMessage());
  }

  die('Captcha solved: ' . $result->code); 
  // https://github.com/2captcha/2captcha-csharp
  AudioCaptcha captcha = new AudioCaptcha();
  byte[] bytes = File.ReadAllBytes("../../resources/audio-en.mp3");
  string base64EncodedImage = Convert.ToBase64String(bytes);
  captcha.SetBase64(base64EncodedImage);
  // https://github.com/2captcha/2captcha-java
  TwoCaptcha solver = new TwoCaptcha("YOUR_API_KEY");
  byte[] bytes = Files.readAllBytes(Paths.get("src/main/resources/audio-en.mp3"));
  String base64EncodedImage = Base64.getEncoder().encodeToString(bytes);
  Audio captcha = new Audio();
  captcha.setBase64(base64EncodedImage);
  # https://github.com/2captcha/2captcha-ruby
  require 'api_2captcha'

  client =  Api2Captcha.new("YOUR_API_KEY")

  result = client.audio({
      audio: "path/to/audio.jpg",
      lang: "en"
  })