@2captcha/captcha-solver 1.2.0 → 1.3.0

package/README.md

@@ -9,15 +9,15 @@
 
 # JavaScript module for 2Captcha API (captcha solver)
 
-The easiest way to quickly integrate the [2Captcha](https://2captcha.com/) captcha-solving service into your code and automate the solving of any type of captcha.
-Examples of API requests for different captcha types are available on the [JavaScript captcha solver](https://2captcha.com/lang/javascript) page.
+The easiest way to quickly integrate the [2Captcha] captcha-solving service into your code and automate the solving of any type of captcha.
+Examples of API requests for different captcha types are available on the [JavaScript captcha solver] page.
 
 - [JavaScript module for 2Captcha API (captcha solver)](#javascript-module-for-2captcha-api-captcha-solver)
   - [Installation](#installation)
   - [Configuration](#configuration)
     - [TwoCaptcha instance options](#twocaptcha-instance-options)
   - [Solve captcha](#solve-captcha)
-    - [Image captchas](#image-captcha)
+    - [Image Captcha](#image-captcha)
     - [reCAPTCHA v2](#recaptcha-v2)
     - [reCAPTCHA v3](#recaptcha-v3)
     - [hCaptcha](#hcaptcha)
@@ -36,15 +36,26 @@ Examples of API requests for different captcha types are available on the [JavaS
     - [Friendly Captcha](#friendly-captcha)
     - [Bounding Box Method](#bounding-box-method)
     - [Grid](#grid)
+    - [Text Captcha](#text-captcha)
+    - [Canvas](#canvas)
+    - [Rotate](#rotate)
+    - [KeyCaptcha](#keycaptcha)
+    - [Cutcaptcha](#cutcaptcha)
+    - [Tencent](#tencent)
+    - [atbCAPTCHA](#atbcaptcha)
+    - [Audio Captcha](#audio-captcha)
   - [Other methods](#other-methods)
     - [goodReport](#goodreport)
     - [badReport](#badreport)
     - [balance](#balance)
   - [Proxies](#proxies)
   - [Examples](#examples)
-  - [Useful articles](#useful-articles)
+  - [Examples using Puppeteer](#examples-using-puppeteer)
+- [Useful articles](#useful-articles)
 - [Get in touch](#get-in-touch)
 - [Join the team 👪](#join-the-team-)
+- [License](#license)
+  - [Graphics and Trademarks](#graphics-and-trademarks)
 
 
 ## Installation
@@ -108,7 +119,6 @@ Below you can find basic examples for every captcha type, check out the code bel
 To bypass a normal captcha (distorted text on an image) use the following method. This method can also be used to recognize any text in an image.
 
 ```js
-// Read from a file as base64 text
 const imageBase64 = fs.readFileSync("./examples/media/imageCaptcha_6e584.png", "base64")
 
 solver.imageCaptcha({
@@ -118,7 +128,6 @@ solver.imageCaptcha({
     max_len: 5
 })
 .then((res) => {
-  // Logs the image text
   console.log(res);
 })
 .catch((err) => {
@@ -497,6 +506,164 @@ solver.grid({
 })
 ```
 
+### Text Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_text_captcha)</sup>
+
+This method can be used to bypass a captcha that requires answering a question provided in clear text.
+
+```js
+solver.textCaptcha({
+  textcaptcha: "If tomorrow is Saturday, what day is today?",
+  lang: 'en'
+})
+.then((res) => {
+    console.log(res);
+})
+.catch((err) => {
+    console.log(err);
+})
+```
+
+### Canvas
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#canvas)</sup>
+
+The canvas method can be used when you need to draw a line around an object on an image. Returns a set of points' coordinates to draw a polygon.
+
+```js
+solver.canvas({
+    body: 'iVBORw0KGgoAAAANSgAAAcIA...',
+    imginstructions: '/9j/4AAQSkZJRgABAQEA...',
+    textinstructions: 'Highlight the red CIRCLE'
+})
+.then((res) => {
+    console.log(res);
+})
+.catch((err) => {
+    console.log(err);
+})
+```
+
+### Rotate
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_rotatecaptcha)</sup>
+
+This method can be used to solve a captcha that asks to rotate an object. It is mostly used to bypass FunCaptcha. Returns the rotation angle.
+
+```js
+solver.rotate({
+  body: imageBase64,
+  textinstructions: "Rotate the object to the correct position"
+})
+.then((res) => {
+    console.log(res);
+})
+.catch((err) => {
+    console.log(err);
+})
+```
+
+### KeyCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_keycaptcha)</sup>
+
+Token-based method to solve KeyCaptcha.
+
+```js
+solver.keyCaptcha({
+    pageurl: "https://2captcha.com/demo/keycaptcha",
+    userId: '184015',
+    sessionId: '0917788cad24ad3a69813c4fcd556061',
+    webServerSign: '02f7f9669f1269595c4c69bcd4a3c52e',
+    webServerSign2: 'd888700f6f324ec0f32b44c32c50bde1'
+})
+.then((res) => {
+    console.log(res);
+})
+.catch((err) => {
+    console.log(err);
+})
+```
+
+### Cutcaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#cutcaptcha)</sup>
+
+Use this method to solve Cutcaptcha. Returns the response in JSON.
+
+```js
+solver.cutCaptcha({
+    pageurl: "https://mysite.com/page/with/cutcaptcha",
+    misery_key: "098e6a849af406142e3150dbf4e6d0538db2b51f", 
+    api_key: "SAs61IAI",
+})
+.then((res) => {
+console.log(res);
+})
+.catch((err) => {
+console.log(err);
+})
+```
+
+### Tencent
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#tencent)</sup>
+
+Use this method to solve Tencent captcha. Returns the response in JSON.
+
+```js
+solver.tencent({
+    pageurl: "https://mysite.com/page/with/tencent",
+    appId: "189956587"  
+})
+.then((res) => {
+console.log(res);
+})
+.catch((err) => {
+console.log(err);
+})
+```
+
+### atbCAPTCHA
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#atb-captcha)</sup>
+
+Use this method to solve atbCAPTCHA challenge. Returns a token to bypass the captcha.
+
+```js
+solver.atbCaptcha({
+    pageurl: "https://mysite.com/page/with/atbCAPTCHA",
+    appId: "af25e409b33d722a95e56a230ff8771c",
+    apiServer: "https://cap.aisecurius.com"
+})
+.then((res) => {
+console.log(res);
+})
+.catch((err) => {
+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
@@ -551,13 +718,20 @@ solver.recaptcha({
 
 Examples of solving all supported captcha types are located in the [examples] directory.
 
+## Examples using Puppeteer
+Also we have a separate repositories you can find examples of solving captcha using Puppeteer.
+At the moment we have implemented examples of bypassing Cloudflare Challenge page and reCAPTCHA.
+Links: 
+- [Cloudflare Bypassing Demo using Puppeteer](https://github.com/2captcha/cloudflare-demo)
+- [Solving reCAPTCHA V2 using Puppeteer and clicks](https://github.com/2captcha/puppeteer-recaptcha-solver-using-clicks)
+- [Custom Slider Captcha Demo](https://github.com/2captcha/custom-slider-demo)
+
+
 ## Useful articles
 * [How to bypass captcha using JavaScript](https://2captcha.com/blog/how-to-use-javascript-to-bypass-captcha#how-to-solve-and-bypass-a-captcha-with-javascript-using-npm-package-2captchacaptcha-solver)
 * [Bypassing Cloudflare Challenge with Puppeteer and 2Captcha](https://2captcha.com/blog/bypassing-cloudflare-challenge-with-puppeteer-and-2captcha)
 * [How to bypass Geetest v4 CAPTCHA](https://2captcha.com/blog/geetest-v4-support)
 * [Automatic reCAPTCHA V3 resolution - a tutorial for developers and customers](https://2captcha.com/blog/recaptcha-v3-automatic-resolution)
-* [Custom Slider Captcha Demo](https://github.com/2captcha/custom-slider-demo)
-* [Cloudflare Challenge page bypass code example](https://github.com/2captcha/cloudflare-demo)
 
 ## Get in touch
 
@@ -570,7 +744,17 @@ There are many ways to contribute, of which development is only one! Find your n
 
 <a href="mailto:job@2captcha.com"><img src="https://github.com/user-attachments/assets/36d23ef5-7866-4841-8e17-261cc8a4e033" width="80" height="30"></a>
 
+## License
+
+The code in this repository is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.
+
+### Graphics and Trademarks
+
+The graphics and trademarks included in this repository are not covered by the MIT License. Please contact <a href="mailto:support@2captcha.com">support</a> for permissions regarding the use of these materials.
+
 <!-- Shared links -->
+[2Captcha]: https://2captcha.com/
+[JavaScript captcha solver]: https://2captcha.com/lang/javascript
 [post options]: https://2captcha.com/2captcha-api#normal_post
 [list of supported languages]: https://2captcha.com/2captcha-api#language
 [Buy residential proxies]: https://2captcha.com/proxy/residential-proxies

package/dist/structs/2captcha.d.ts

@@ -66,18 +66,6 @@ export interface paramsGeetest {
     proxytype?: string;
     userAgent?: string;
 }
-/**
- * Interface for yandexSmart captcha
- *
- * @typedef {object} yandexSmart
- * @property {string} pageurl URL of the page where the captcha is located
- * @property {string} sitekey The `sitekey` value you found on the captcha page
- * @property {string} pingback
- * @property {string} proxy Format: `login:password@123.123.123.123:3128`. You can find more info about proxies [here](https://2captcha.com/2captcha-api#proxies).
- * @property {string} proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
- * @property {string} userAgent Your `userAgent` that will be passed to our worker and used to solve the captcha.
- *
- */
 export interface yandexSmart {
     pageurl: string;
     sitekey: string;
@@ -86,18 +74,6 @@ export interface yandexSmart {
     proxytype?: string;
     userAgent?: string;
 }
-/**
- * Interface for GeeTest V4 captcha
- *
- * @typedef {object} paramsGeeTestV4
- * @property {string} pageurl Required parameter. URL of the page where the captcha is located
- * @property {string} captcha_id Required parameter. Value of `captcha_id` parameter you found on target website.
- * @property {string} pingback An optional param. [More info here](https://2captcha.com/2captcha-api#pingback).
- * @property {string} proxy An optional param. Format: `login:password@123.123.123.123:3128`
- * @property {string} proxytype An optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
- * @property {string} userAgent An optional param. Your `userAgent` that will be passed to our worker and used to solve the captcha.
- *
- */
 export interface paramsGeeTestV4 {
     pageurl: string;
     captcha_id: string;
@@ -180,6 +156,14 @@ export interface paramsMTCaptcha {
     proxy?: string;
     proxytype?: string;
 }
+export interface paramsCutcaptcha {
+    pageurl: string;
+    miseryKey: string;
+    apiKey: string;
+    pingback?: string;
+    proxy?: string;
+    proxytype?: string;
+}
 export interface friendlyCaptcha {
     pageurl: string;
     sitekey: string;
@@ -194,18 +178,63 @@ export interface paramsBoundingBox {
 }
 export interface paramsGrid {
     body: string;
-    recaptcha: 1;
+    recaptcha: number;
+    canvas?: number;
     rows?: number;
     cols?: number;
-    minСlicks?: number;
-    maxСlicks?: number;
+    minClicks?: number;
+    maxClicks?: number;
     previousId?: string;
+    imgType?: string;
     textinstructions?: string;
     imginstructions?: string;
     canSkip?: number;
     lang?: string;
     pingback?: string;
 }
+export interface paramsTextcaptcha {
+    textcaptcha: string;
+    lang?: string;
+    pingback?: string;
+}
+export interface paramsRotateCaptcha {
+    body: string;
+    angle?: number;
+    pingback?: string;
+    lang?: string;
+    textinstructions?: string;
+    imginstructions?: string;
+}
+export interface paramsKeyCaptcha {
+    pageurl: string;
+    userId: string;
+    sessionId: string;
+    webServerSign: string;
+    webServerSign2: string;
+    pingback?: string;
+    proxy?: string;
+    proxytype?: string;
+}
+export interface paramsTencent {
+    pageurl: string;
+    appId: string;
+    pingback?: string;
+    proxy?: string;
+    proxytype?: string;
+}
+export interface paramsAtbCaptcha {
+    pageurl: string;
+    appId: string;
+    apiServer: string;
+    pingback?: string;
+    proxy?: string;
+    proxytype?: string;
+}
+export interface paramsAudioCaptcha {
+    body: string;
+    lang: string;
+    pingback?: string;
+}
 /**
  * An object containing properties of the captcha solution.
  * @typedef {Object} CaptchaAnswer
@@ -588,7 +617,7 @@ export declare class Solver {
      *
      * [Read more about Cloudflare Turnstile captcha](https://2captcha.com/2captcha-api#turnstile).
      *
-     * @param {{ pageurl, sitekey, action, data, pingback, proxy, proxytype}} params The `сloudflareTurnstile` method takes arguments as an object. Thus, the `pageurl`, `sitekey` fields in the passed object are mandatory.
+     * @param {{ pageurl, sitekey, action, data, pingback, proxy, proxytype}} params The `cloudflareTurnstile` method takes arguments as an object. Thus, the `pageurl`, `sitekey` fields in the passed object are mandatory.
      * @param {string} params.pageurl 	Full `URL` of the page where you see the captcha.
      * @param {string} params.sitekey Is a value of `sitekey` parameter in the page source.
      * @param {string} params.action Value of optional `action` parameter you found on page.
@@ -613,7 +642,7 @@ export declare class Solver {
     /**
      * ### Solves a Coordinates captcha.
      *
-     * @param {{ body, imginstructions, textinstructions, language, lang, pingback }} params parameters Сoordinates Captcha as an object.
+     * @param {{ body, imginstructions, textinstructions, language, lang, pingback }} params parameters Coordinates Captcha as an object.
      * @param {string} params.body Base64-encoded captcha image.
      * @param {string} params.imginstructions Base64-encoded image with instruction for solving captcha.
      * @param {string} params.textinstructions Text will be shown to worker to help him to solve the captcha correctly. For example: click on all objects in red color.
@@ -739,28 +768,36 @@ export declare class Solver {
      */
     mtCaptcha(params: paramsMTCaptcha): Promise<CaptchaAnswer>;
     /**
-     * ### Solves Cutcaptcha
+     * ### Solves a Cutcaptcha.
      *
-     * @param {{ pageurl, sitekey, userAgent, pingback, proxy, proxytype}} params Parameters MTCaptcha as an object.
-     * @param {string} params.pageurl 	Full `URL` of the page where you see the captcha.
-     * @param {string} params.sitekey TThe value of `sitekey` parameter found on the page.
-     * @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://2captcha.com/2captcha-api#pingback).
-     * @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://2captcha.com/2captcha-api#proxies).
-     * @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
+     * Use this method to solve Cutcaptcha. Returns the response in JSON.
+     * [Read more about Cutcaptcha Method](https://2captcha.com/2captcha-api#cutcaptcha).
+     *
+     * @param {{ pageurl, miseryKey, apiKey, pingback, proxy, proxytype }} params Parameters for solving Cutcaptcha as an object.
+     * @param {string} params.pageurl The URL where the captcha is located.
+     * @param {string} params.miseryKey The value of `CUTCAPTCHA_MISERY_KEY` variable defined on page.
+     * @param {string} params.apiKey The value of `data-apikey` attribute of iframe's body. Also the name of javascript file included on the page
+     * @param {string} [params.pingback] Optional param. URL for pingback (callback) response when captcha is solved.
+     * @param {string} [params.proxy] Optional param. Proxy to use while solving the captcha. Format: `login:password@123.123.123.123:3128`.
+     * @param {string} [params.proxytype] Optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
+     *
+     * @returns {Promise<CaptchaAnswer>} The result from the solve.
+     * @throws APIError
      *
      * @example
      * solver.cutCaptcha({
-     *   pageurl: "https://service.mtcaptcha.com/mtcv1/demo/index.html",
-     *   sitekey: "MTPublic-DemoKey9M"
+     *   pageurl: "https://mysite.com/page/with/cutcaptcha",
+     *   miseryKey: "098e6a849af406142e3150dbf4e6d0538db2b51f",
+     *   apiKey: "SAs61IAI",
      * })
      * .then((res) => {
-     *   console.log(res);
-     *  })
+     *     console.log(res);
+     * })
      * .catch((err) => {
-     *   console.log(err);
+     *     console.log(err);
      * })
      */
-    cutCaptcha(params: paramsMTCaptcha): Promise<CaptchaAnswer>;
+    cutCaptcha(params: paramsCutcaptcha): Promise<CaptchaAnswer>;
     /**
      * ### Solves Friendly Captcha
      *
@@ -810,14 +847,15 @@ export declare class Solver {
      *
      * The method can be used to bypass tasks where a grid is applied to an image and you need to click on grid tiles, like reCAPTCHA or hCaptcha images.
      *
-     * @param {{ body, textinstructions, imginstructions, rows, cols, minСlicks, maxСlicks, previousId, canSkip, lang, pingback}} params Parameters Grid Method as an object.
+     * @param {{ body, textinstructions, imginstructions, rows, cols, minClicks, maxClicks, imgType, previousId, canSkip, lang, pingback}} params Parameters Grid Method as an object.
      * @param {string} params.body `Base64`- encoded captcha image.
      * @param {string} params.textinstructions Text will be shown to worker to help him to select object on the image correctly. For example: "*Select cars in the image*". **Optional parameter**, if the instruction already exists in the form of the `imginstructions`.
      * @param {string} params.imginstructions Image with instruction for worker to help him to select object on the image correctly. The image must be encoded in `Base64` format. **Optional parameter**, if the instruction already exists in the form of the `textinstructions`.
      * @param {number} params.rows Number of rows in grid captcha.
      * @param {number} params.cols Number of columns in grid captcdha.
-     * @param {number} params.minСlicks The minimum number of tiles that must be selected. Can't be more than `rows` * `cols`.
-     * @param {number} params.maxСlicks The maximum number of tiles that can be selected on the image.
+     * @param {number} params.minClicks The minimum number of tiles that must be selected. Can't be more than `rows` * `cols`.
+     * @param {number} params.maxClicks The maximum number of tiles that can be selected on the image.
+     * @param {string} params.imgType The image will be recognized using Computer Vision. Supported value options: `recaptcha`, `hcaptcha`, `funcaptcha`, `funcaptcha_compare`. [More info here](https://2captcha.com/2captcha-api#grid).
      * @param {string} params.previousId Id of your previous request with the same captcha challenge.
      * @param {number} params.canSkip Set the value to `1` only if it's possible that there's no images matching to the instruction. We'll provide a button "No matching images" to worker and you will receive `No_matching_images` as answer.
      * @param {string} params.lang Language code. [See the list of supported languages](https://2captcha.com/2captcha-api#language).
@@ -837,6 +875,210 @@ export declare class Solver {
      * })
      */
     grid(params: paramsGrid): Promise<CaptchaAnswer>;
+    /**
+     * ### Text Captcha method
+     *
+     * Text Captcha is a type of captcha that is represented as text and doesn't contain images. Usually you have to answer a question to pass the verification. For example: "If tomorrow is Saturday, what day is today?".
+     * [Read more about Text Captcha Method](https://2captcha.com/2captcha-api#text-captcha).
+     *
+     * @param {{ textcaptcha, lang, pingback}} params Parameters Text Captcha Method as an object.
+     * @param {string} params.textcaptcha Text Captcha is a type of captcha that is represented as text and doesn't contain images. Usually you have to answer a question to pass the verification.
+     * @param {string} params.lang Language code. [See the list of supported languages](https://2captcha.com/2captcha-api#language).
+     * @param {string} params.pingback params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://2captcha.com/2captcha-api#pingback).
+     *
+     * @example
+     * solver.text({
+     *   textcaptcha: "If tomorrow is Saturday, what day is today?",
+     *   lang: 'en'
+     * })
+     * .then((res) => {
+     *   console.log(res);
+     *  })
+     * .catch((err) => {
+     *   console.log(err);
+     * })
+     */
+    text(params: paramsTextcaptcha): Promise<CaptchaAnswer>;
+    /**
+     * ### Canvas method
+     *
+     * This method can be used to bypass tasks in which you need to circle an object or line in an image.
+     * [Read more about Canvas Method](https://2captcha.com/2captcha-api#canvas).
+     *
+     * @param {{ body, textinstructions, imginstructions, canSkip, lang, pingback}} params Parameters Canvas as an object.
+     * @param {string} params.body `Base64`- encoded captcha image.
+     * @param {string} params.textinstructions Text will be shown to worker to help him to select object on the image correctly. For example: "*Select cars in the image*". **Optional parameter**, if the instruction already exists in the form of the `imginstructions`.
+     * @param {string} params.imginstructions Image with instruction for worker to help him to select object on the image correctly. The image must be encoded in `Base64` format. **Optional parameter**, if the instruction already exists in the form of the `textinstructions`.
+     * @param {number} params.canSkip Set the value to `1` only if it's possible that there's no images matching to the instruction. We'll provide a button "No matching images" to worker and you will receive `No_matching_images` as answer.
+     * @param {string} params.lang Language code. [See the list of supported languages](https://2captcha.com/2captcha-api#language).
+     * @param {string} params.pingback params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://2captcha.com/2captcha-api#pingback).
+     *
+     * @example
+     * solver.canvas({
+     *   body: 'iVBORw0KGgoAAAANSgAAAcIA...',
+     *   imginstructions: '/9j/4AAQSkZJRgABAQEA...',
+     *   textinstructions: 'Highlight the red CIRCLE'
+     * })
+     * .then((res) => {
+     *   console.log(res);
+     *  })
+     * .catch((err) => {
+     *   console.log(err);
+     * })
+     */
+    canvas(params: paramsGrid): Promise<CaptchaAnswer>;
+    /**
+     * ### Rotate method
+     *
+     * This method can be used to solve a captcha that asks to rotate an object. It is mostly used to bypass FunCaptcha. Returns the rotation angle.
+     * [Read more about Rotate Method](https://2captcha.com/2captcha-api#solving_rotatecaptcha).
+     *
+     * @param {{ body, angle, pingback, lang, textinstructions, imginstructions }} params Parameters for solving Rotate Captcha as an object.
+     * @param {string} params.body Base64-encoded image of the captcha that needs to be rotated.
+     * @param {number} params.angle Angle to which the captcha needs to be rotated to solve it correctly. Value between `0` to `360`.
+     * @param {string} params.textinstructions Optional param. Text instruction that will be shown to worker to help solve the captcha correctly.
+     * @param {string} params.imginstructions Optional param. Base64-encoded image instruction that will be shown to worker to help solve the captcha correctly.
+     * @param {string} params.lang Optional param. Language code for worker to use while solving the captcha.
+     * @param {string} params.pingback Optional param. URL for pingback (callback) response when captcha is solved.
+     *
+     * @returns {Promise<CaptchaAnswer>} The result from the solve.
+     * @throws APIError
+     *
+     * @example
+     * solver.rotate({
+     *   body: "iVBORw0KGgoAAAANSUhEUgAAAcIA...",
+     *   angle: 15,
+     *   textinstructions: "Rotate the object to the correct position"
+     * })
+     * .then((res) => {
+     *     console.log(res);
+     * })
+     * .catch((err) => {
+     *     console.log(err);
+     * })
+     */
+    rotate(params: paramsRotateCaptcha): Promise<CaptchaAnswer>;
+    /**
+    * ### Solves a KeyCaptcha.
+    *
+    * This method can be used to solve a KeyCaptcha. It is mostly used to bypass captchas that use KeyCaptcha technology.
+    * [Read more about KeyCaptcha Method](https://2captcha.com/2captcha-api#solving_keycaptcha).
+    *
+    * @param {{ pageurl, userId, sessionId, webServerSign, webServerSign2, pingback, proxy, proxytype }} params Parameters for solving KeyCaptcha as an object.
+    * @param {string} params.pageurl The URL where the captcha is located.
+    * @param {string} params.userId Value of `s_s_c_user_id` parameter you found on page.
+    * @param {string} params.sessionId Value of `s_s_c_session_id` parameter you found on page.
+    * @param {string} params.webServerSign Value of `s_s_c_web_server_sign` parameter you found on page.
+    * @param {string} params.webServerSign2 Value of `s_s_c_web_server_sign2` parameter you found on page.
+    * @param {string} [params.pingback] Optional param. URL for pingback (callback) response when captcha is solved.
+    * @param {string} [params.proxy] Optional param. Proxy to use while solving the captcha. Format: `login:password@123.123.123.123:3128`.
+    * @param {string} [params.proxytype] Optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
+    *
+    * @returns {Promise<CaptchaAnswer>} The result from the solve.
+    * @throws APIError
+    *
+    * @example
+    * solver.keyCaptcha({
+    *   pageurl: "https://2captcha.com/demo/keycaptcha",
+    *   userId: "184015",
+    *   sessionId: "11975dc265ce9174a54edb1619af15b7",
+    *   webServerSign: "73ef77fd3cf0ce02947d9088bdc8412a",
+    *   webServerSign2: "93836d9e7007f38f072ce07d89bb7e2b"
+    * })
+    * .then((res) => {
+    *     console.log(res);
+    * })
+    * .catch((err) => {
+    *     console.log(err);
+    * })
+    */
+    keyCaptcha(params: paramsKeyCaptcha): Promise<CaptchaAnswer>;
+    /**
+    * ### Solves a Tencent.
+    *
+    * Use this method to solve Tencent captcha. Returns a token.
+    * [Read more about Tencent Method](https://2captcha.com/2captcha-api#tencent).
+    *
+    * @param {{ pageurl, appId, pingback, proxy, proxytype }} params Parameters for solving Tencent as an object.
+    * @param {string} params.pageurl The URL where the captcha is located.
+    * @param {string} params.appId 	The value of `appId` parameter in the website source code.
+    * @param {string} [params.pingback] Optional param. URL for pingback (callback) response when captcha is solved.
+    * @param {string} [params.proxy] Optional param. Proxy to use while solving the captcha. Format: `login:password@123.123.123.123:3128`.
+    * @param {string} [params.proxytype] Optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
+    *
+    * @returns {Promise<CaptchaAnswer>} The result from the solve.
+    * @throws APIError
+    *
+    * @example
+    * solver.tencent({
+    *   pageurl: "https://mysite.com/page/with/tencent",
+    *   appId: "189956587"
+    * })
+    * .then((res) => {
+    *     console.log(res);
+    * })
+    * .catch((err) => {
+    *     console.log(err);
+    * })
+    */
+    tencent(params: paramsTencent): Promise<CaptchaAnswer>;
+    /**
+    * ### Solves a atbCAPTCHA.
+    *
+    * Use this method to solve atbCAPTCHA captcha. Returns a token.
+    * [Read more about atbCAPTCHA Method](https://2captcha.com/2captcha-api#atb-captcha).
+    *
+    * @param {{ pageurl, appId, apiServer, pingback, proxy, proxytype }} params Parameters for solving atbCAPTCHA as an object.
+    * @param {string} params.pageurl The URL where the captcha is located.
+    * @param {string} params.appId 	The value of `appId` parameter in the website source code.
+    * @param {string} params.apiServer The value of `apiServer` parameter in the website source code.
+    * @param {string} [params.pingback] Optional param. URL for pingback (callback) response when captcha is solved.
+    * @param {string} [params.proxy] Optional param. Proxy to use while solving the captcha. Format: `login:password@123.123.123.123:3128`.
+    * @param {string} [params.proxytype] Optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
+    *
+    * @returns {Promise<CaptchaAnswer>} The result from the solve.
+    * @throws APIError
+    *
+    * @example
+    * solver.atbCaptcha({
+    *   pageurl: "https://mysite.com/page/with/tencent",
+    *   appId: "af25e409b33d722a95e56a230ff8771c",
+        apiServer: "https://cap.aisecurius.com"
+    * })
+    * .then((res) => {
+    *     console.log(res);
+    * })
+    * .catch((err) => {
+    *     console.log(err);
+    * })
+    */
+    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 recognition Method](https://2captcha.com/2captcha-api#audio-recognition).
+     *
+     * @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);
+     * })
+     */
+    audio(params: paramsAudioCaptcha): Promise<CaptchaAnswer>;
     /**
      * Reports a captcha as correctly solved.
      *