Add Audio method

Author: dzmitry-duboyski

README.md

@@ -43,6 +43,7 @@ Examples of API requests for different captcha types are available on the [JavaS
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
     - [atbCAPTCHA](#atbcaptcha)
+    - [Audio Captcha](#audio-captcha)
   - [Other methods](#other-methods)
     - [goodReport](#goodreport)
     - [badReport](#badreport)
@@ -646,6 +647,25 @@ console.log(err);
 })
 ```
 
+### Audio Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#audio-recognition)</sup>
+
+Use the following method to bypass an audio captcha (`mp3` formats only). You must provide the language as `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt", "fr".
+
+```js
+solver.audio({
+  body: "SUQzBAAAAAAAHFRTU0UAAAA...",
+  lang: "en"
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
 ## Other methods
 
 ### goodReport

examples/audio.js

@@ -0,0 +1,17 @@
+const TwoCaptcha = require("../dist/index.js");
+require('dotenv').config();
+const APIKEY = process.env.APIKEY
+const solver = new TwoCaptcha.Solver(APIKEY);
+const fs = require('fs')
+const audioCaptchaBase64 = fs.readFileSync("./media/example.mp3", "base64")
+
+solver.audio({
+  body: audioCaptchaBase64,
+  lang: 'en'
+})
+.then((res) => {
+    console.log(res);
+})
+.catch((err) => {
+    console.log(err);
+})

examples/media/example.mp3

@@ -291,6 +291,12 @@ export interface paramsAtbCaptcha{
     proxytype?: string
 }
 
+export interface paramsAudioCaptcha {
+    body: string,
+    lang: string,
+    pingback?: string,
+}
+
 /**
  * An object containing properties of the captcha solution.
  * @typedef {Object} CaptchaAnswer
@@ -1851,6 +1857,63 @@ public async atbCaptcha(params: paramsAtbCaptcha): Promise<CaptchaAnswer> {
     }
 }
 
+
+/**
+ * ### Method for solving Audio captcha.
+ * 
+ * Use the following method to bypass an audio captcha (`mp3` formats only). You must provide the language as `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt", "fr".
+ * [Read more about audio captcha parameters](https://2captcha.com/2captcha-api#audio).
+ * 
+ * @param {{ body, lang, pingback }} params Object containing parameters for the audio captcha.
+ * @param {string} params.body Base64 encoded audio file in `mp3` format. Max file size: 1 MB.
+ * @param {string} params.lang The language of audio record. Supported languages are: "en", "ru", "de", "el", "pt", "fr".
+ * @param {string} [params.pingback] URL for pingback response once captcha is solved.
+ * 
+ * @returns {Promise<CaptchaAnswer>} The result from solving the audio captcha.
+ * @throws APIError
+ * @example
+ * solver.audio({
+ *   body: "SUQzBAAAAAAAHFRTU0UAAAA...",
+ *   lang: "en"
+ * })
+ * .then((res) => {
+ *   console.log(res);
+ * })
+ * .catch((err) => {
+ *   console.log(err);
+ * })
+ */
+public async audio(params: paramsAudioCaptcha): Promise<CaptchaAnswer> {
+    checkCaptchaParams(params, "audio")
+
+    const payload = {
+        ...params,
+        method: "audio",
+        ...this.defaultPayload
+    }
+
+    const response = await fetch(this.in, {
+        method: 'post',
+        body: JSON.stringify(payload),
+        headers: {'Content-Type': 'application/json'}
+    })
+
+    const result = await response.text()
+
+    let data;
+    try {
+        data = JSON.parse(result)
+    } catch {
+        throw new APIError(result)
+    }
+
+    if (data.status == 1) {
+        return this.pollResponse(data.request)
+    } else {
+        throw new APIError(data.request)
+    }
+}
+
     /**
      * Reports a captcha as correctly solved.
      * 

src/structs/2captcha.ts

@@ -1,6 +1,7 @@
 // Captcha methods for which parameter checking is available
 const supportedMethods = ["userrecaptcha", "hcaptcha", "geetest", "geetest_v4","yandex","funcaptcha","lemin","amazon_waf",
-"turnstile", "base64", "capy","datadome", "cybersiara", "mt_captcha", "bounding_box", 'friendly_captcha', 'grid', 'textcaptcha', 'canvas', 'rotatecaptcha', 'keycaptcha', 'cutcaptcha', 'tencent', 'atb_captcha']
+"turnstile", "base64", "capy","datadome", "cybersiara", "mt_captcha", "bounding_box", 'friendly_captcha', 'grid',
+ 'textcaptcha', 'canvas', 'rotatecaptcha', 'keycaptcha', 'cutcaptcha', 'tencent', 'atb_captcha', 'audio']
 
 // Names of required fields that must be contained in the parameters captcha
 const recaptchaRequiredFields =   ['pageurl','googlekey']
@@ -28,6 +29,7 @@ const keycaptchaRequiredFields =  ['pageurl', 's_s_c_user_id', 's_s_c_session_id
 const cutcaptchaRequiredFields =  ['pageurl', 'misery_key', 'api_key'] 
 const tencentRequiredFields =     ['pageurl', 'app_id']
 const atbCaptchaRequiredFields =  ['pageurl', 'app_id', 'api_server']
+const audioRequiredFields =       ['body', 'lang']
 
 /**
  * Getting required arguments for a captcha.
@@ -111,6 +113,9 @@ const getRequiredFildsArr = (method: string):Array<string> => {
     case "atb_captcha":
       requiredFieldsArr = atbCaptchaRequiredFields
       break;
+    case "audio":
+      requiredFieldsArr = audioRequiredFields
+      break;
   }
   return requiredFieldsArr
 }