Fix stuff and add examples to speech

Author: proguy914629bot

examples/async/speech/speech_to_text.py

@@ -0,0 +1,26 @@
+from openrobot.api_wrapper import AsyncClient
+
+client = AsyncClient(...)
+
+# Perform Text To Speech
+
+# From file
+from io import BytesIO
+
+file_bytes = BytesIO(...)
+
+stt = await client.speech.speech_to_text(file_bytes, language_code=...)
+
+# From URL
+url = ...
+
+stt = await client.speech.speech_to_text(url, language_code=...)
+
+
+stt.text # ...
+stt.duration # ...
+
+
+# Get details on Text To Speech such as supported languages, etc.
+
+await client.speech.speech_to_text_support() # {'languages': ['Language Codes']}

examples/async/speech/text_to_speech.py

@@ -0,0 +1,26 @@
+from openrobot.api_wrapper import AsyncClient
+
+client = AsyncClient(...)
+
+# Perform Text to speech
+
+text = 'Hello World'
+
+tts = await client.speech.text_to_speech(text, 'en-US', ...) # Get it by doing details (Speech.text_to_speech_support)
+
+tts_url = tts.url # https://cdn.openrobot.xyz/speech/text-to-speech/...
+
+# Get details on Speech To Text such as a list of Voices from a specific language, etc.
+
+tts_support = await client.speech.text_to_speech_support('en-US')
+
+for language in tts_support.languages:
+    language.name
+    language.code
+
+for voice in tts_support.voices:
+    voice.gender
+    voice.id
+    voice.language.name
+    voice.language.code
+    voice.name

examples/sync/speech/speech_to_text.py

@@ -0,0 +1,26 @@
+from openrobot.api_wrapper import SyncClient
+
+client = SyncClient(...)
+
+# Perform Text To Speech
+
+# From file
+from io import BytesIO
+
+file_bytes = BytesIO(...)
+
+stt = client.speech.speech_to_text(file_bytes, language_code=...)
+
+# From URL
+url = ...
+
+stt = client.speech.speech_to_text(url, language_code=...)
+
+
+stt.text # ...
+stt.duration # ...
+
+
+# Get details on Text To Speech such as supported languages, etc.
+
+client.speech.speech_to_text_support() # {'languages': ['Language Codes']}

examples/sync/speech/text_to_speech.py

@@ -0,0 +1,26 @@
+from openrobot.api_wrapper import SyncClient
+
+client = SyncClient(...)
+
+# Perform Text to speech
+
+text = 'Hello World'
+
+tts = client.speech.text_to_speech(text, 'en-US', ...) # Get it by doing details (Speech.text_to_speech_support)
+
+tts_url = tts.url # https://cdn.openrobot.xyz/speech/text-to-speech/...
+
+# Get details on Speech To Text such as a list of Voices from a specific language, etc.
+
+tts_support = client.speech.text_to_speech_support('en-US')
+
+for language in tts_support.languages:
+    language.name
+    language.code
+
+for voice in tts_support.voices:
+    voice.gender
+    voice.id
+    voice.language.name
+    voice.language.code
+    voice.name

openrobot/api_wrapper/speech.py

@@ -52,7 +52,7 @@ def speech_to_text(self, source: typing.Union[str, io.BytesIO], language_code: s
         if self._is_async:
             async def _text_to_speech() -> TextToSpeechResult:
                 if isinstance(source, str):
-                    js = await self._client.request('POST', '/api/speech/speech-to-text', params={'url': source})
+                    js = await self._client.request('POST', '/api/speech/speech-to-text', params={'url': source, 'language_code': language_code})
                 elif isinstance(source, io.BytesIO):
                     data = aiohttp.FormData()
                     data.add_field('file', source)
@@ -66,12 +66,12 @@ async def _text_to_speech() -> TextToSpeechResult:
             return _text_to_speech()
         else:
             if isinstance(source, str):
-                js = self._client.request('POST', '/api/speech/speech-to-text', params={'url': source})
+                js = self._client.request('POST', '/api/speech/speech-to-text', params={'url': source, 'language_code': language_code})
             elif isinstance(source, io.BytesIO):
                 data = aiohttp.FormData()
                 data.add_field('file', source)
 
-                js = self._client.request('POST', '/api/speech/speech-to-text', files={'upload_file': getattr(source, 'getvalue', lambda: source)()})
+                js = self._client.request('POST', '/api/speech/speech-to-text', files={'upload_file': getattr(source, 'getvalue', lambda: source)()}, params={'language_code': language_code})
             else:
                 raise OpenRobotAPIError('source must be a URL or BytesIO.')
 
@@ -112,7 +112,7 @@ async def _speech_to_text_support() -> typing.Dict[str, typing.Any]:
 
             return js
 
-    def text_to_speech(self, text: str, language_code: str, voice_id: str, *, engine: str = 'standard') -> typing.Union[typing.Coroutine[None, None, TextToSpeechResult], TextToSpeechResult]:
+    def text_to_speech(self, text: str, language_code: str, voice_id: str, *, engine: typing.Optional[str] = 'standard') -> typing.Union[typing.Coroutine[None, None, TextToSpeechResult], TextToSpeechResult]:
         """|maybecoro|
         
         Text to speech.
@@ -128,7 +128,7 @@ def text_to_speech(self, text: str, language_code: str, voice_id: str, *, engine
             The language code of the speech.
         voice_id: :class:`str`
             The voice id of the speech.
-        engine: :class:`str`
+        engine: Optional[:class:`str`]
             The engine of the speech.
 
         Raises
@@ -158,14 +158,21 @@ async def _text_to_speech() -> TextToSpeechResult:
 
             return TextToSpeechResult(js)
 
-    def text_to_speech_support(self) -> typing.Union[typing.Coroutine[None, None, TextToSpeechSupportResult], TextToSpeechSupportResult]:
+    def text_to_speech_support(self, language_code: str, *, engine: typing.Optional[str] = 'standard') -> typing.Union[typing.Coroutine[None, None, TextToSpeechSupportResult], TextToSpeechSupportResult]:
         """|maybecoro|
 
         Returns the supported details for Text To Speech.
 
         This function is a coroutine if the client is an 
         :class:`AsyncClient` object, else it would be a synchronous method.
 
+        Parameters
+        ----------
+        language_code: :class:`str`
+            The language code to get the supported details for.
+        engine: Optional[:class:`str`]
+            The engine of the speech.
+
         Raises
         ------
         :exc:`Forbidden`
@@ -183,12 +190,12 @@ def text_to_speech_support(self) -> typing.Union[typing.Coroutine[None, None, Te
 
         if self._is_async:
             async def _text_to_speech_support() -> TextToSpeechSupportResult:
-                js = await self._client.request('GET', '/api/speech/text-to-speech/supports')
+                js = await self._client.request('GET', '/api/speech/text-to-speech/supports', params={'language_code': language_code, 'engine': engine})
 
                 return TextToSpeechSupportResult(js)
 
             return _text_to_speech_support()
         else:
-            js = self._client.request('GET', '/api/speech/text-to-speech/supports')
+            js = self._client.request('GET', '/api/speech/text-to-speech/supports', params={'language_code': language_code, 'engine': engine})
 
             return TextToSpeechSupportResult(js)