Audio support (#64)

* Add audio method for solver. #RC-2041

* add audio example, update text

* audio test

* update audio test

* Delete method arg

* Rewrite audio solver

* update audio example

* add audio example

* rm audio test

---------

Co-authored-by: Arkadiy Polukhin <[email protected]>
Co-authored-by: 2captcha <[email protected]>

Author: 3 people

README.md

@@ -8,6 +8,7 @@ The easiest way to quickly integrate [2Captcha] captcha solving service into you
   - [Solve captcha](#solve-captcha)
     - [Captcha options](#captcha-options)
     - [Normal Captcha](#normal-captcha)
+    - [Audio Captcha](#audio-captcha)
     - [Text Captcha](#text-captcha)
     - [ReCaptcha v2](#recaptcha-v2)
     - [ReCaptcha v3](#recaptcha-v3)
@@ -103,6 +104,16 @@ result = solver.normal('path/to/captcha.jpg', param1=..., ...)
 result = solver.normal('https://site-with-captcha.com/path/to/captcha.jpg', param1=..., ...)
 ```
 
+### Audio Captcha
+To bypass an audio captcha (mp3 formats only) use the following method. 
+You must provife the language as  `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt".
+
+```python 
+result = solver.audio('path/to/captcha.mp3', lang = 'lang', param1=..., ...)
+# OR
+result = solver.audio('https://site-with-captcha.com/path/to/captcha.mp3', lang = 'lang', param1=..., ...)
+```
+
 ### Text Captcha
 This method can be used to bypass a captcha that requires to answer a question provided in clear text.
 ```python 

examples/audio.py

@@ -0,0 +1,25 @@
+import sys
+import os
+
+sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__))))
+
+from twocaptcha import TwoCaptcha
+
+# in this example we store the API key inside environment variables that can be set like:
+# export APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Linux or macOS
+# set APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Windows
+# you can just set the API key directly to it's value like:
+# api_key="1abc234de56fab7c89012d34e56fa7b8"
+
+api_key = os.getenv('APIKEY', 'YOUR_API_KEY')
+
+solver = TwoCaptcha(api_key)
+
+try:
+    result = solver.audio('./audio/example.mp3', lang='en')
+
+except Exception as e:
+    sys.exit(e)
+
+else:
+    sys.exit('result: ' + str(result))

examples/audio/example.mp3

@@ -81,6 +81,39 @@ def normal(self, file, **kwargs):
         result = self.solve(**method, **kwargs)
         return result
 
+    def audio(self, file, lang, **kwargs):
+        '''
+        Wrapper for solving audio captcha
+        
+        Required:
+            file (base64, or url to mp3 file)
+            lang ("en", "ru", "de", "el", "pt")
+
+        Optional params:
+        '''
+        method = "audio"
+
+        if not file:
+            raise ValidationException('File is none')
+        elif not '.' in file and len(file) > 50:
+            body = file
+        elif file.endswith(".mp3") and file.startswith("http"):
+            response = requests.get(file)
+            if response.status_code != 200:
+                raise ValidationException(f'File could not be downloaded from url: {file}')
+            body = b64encode(response.content).decode('utf-8')
+        elif file.endswith(".mp3"):
+            with open(file, "rb") as media:
+                body = b64encode(media.read()).decode('utf-8')                
+        else:
+            raise ValidationException('File extension is not .mp3 or it is not a base64 string.')
+
+        if not lang or lang not in ("en", "ru", "de", "el", "pt"):
+            raise ValidationException(f'Lang not in "en", "ru", "de", "el", "pt". You send {lang}')
+
+        result = self.solve(body=body, method=method, **kwargs)
+        return result
+
     def text(self, text, **kwargs):
         '''
         Wrapper for solving text captcha 
@@ -524,7 +557,7 @@ def get_method(self, file):
 
         if not '.' in file and len(file) > 50:
             return {'method': 'base64', 'body': file}
-        
+
         if file.startswith('http'):
             img_resp = requests.get(file)
             if img_resp.status_code != 200: