PY0101EN-5.2_API_2.ipynb

{"cells":[{"cell_type":"markdown","metadata":{},"source":["<center>\n","    <img src=\"https://cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud/IBMDeveloperSkillsNetwork-PY0101EN-SkillsNetwork/IDSNlogo.png\" width=\"300\" alt=\"cognitiveclass.ai logo\"  />\n","</center>\n","\n","# Watson Speech to Text Translator\n","\n","Estimated time needed: **25** minutes\n","\n","## Objectives\n","\n","After completing this lab you will be able to:\n","\n","*   Operate a Speech to Text Translator through an API\n"]},{"cell_type":"markdown","metadata":{},"source":["### Introduction\n","\n","<p>In this notebook, you will learn to convert an audio file of an English speaker to text using a Speech to Text API. Then, you will translate the English version to a Spanish version using a Language Translator API. <b>Note:</b> You must obtain the API keys and endpoints to complete the lab.</p>\n"]},{"cell_type":"markdown","metadata":{},"source":["<div class=\"alert alert-block alert-info\" style=\"margin-top: 20px\">\n","<h2>Table of Contents</h2>\n","<ul>\n","    <li><a href=\"https://#ref0\">Speech To Text</a></li>\n","    <li><a href=\"https://#ref1\">Language Translator</a></li>\n","    <li><a href=\"https://#ref2\">Exercise</a></li>\n","</ul>\n","</div>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["#you will need the following library \n","!pip install ibm_watson wget"]},{"cell_type":"markdown","metadata":{},"source":["<h2 id=\"ref0\">Speech to Text</h2>\n"]},{"cell_type":"markdown","metadata":{},"source":["<p>First we import <code>SpeechToTextV1</code> from <code>ibm_watson</code>. For more information on the API, please click on this <a href=\"https://cloud.ibm.com/apidocs/speech-to-text?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01&code=python\">link</a>.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["from ibm_watson import SpeechToTextV1 \n","import json\n","from ibm_cloud_sdk_core.authenticators import IAMAuthenticator"]},{"cell_type":"markdown","metadata":{},"source":["<p>The service endpoint is based on the location of the service instance, we store the information in the variable URL. To find out which URL to use, view the service credentials and paste the url here.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["url_s2t = \"\""]},{"cell_type":"markdown","metadata":{},"source":["<p>You require an API key, and you can obtain the key on the <a href=\"https://cloud.ibm.com/resources?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01\">Dashboard </a>.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["iam_apikey_s2t = \"\""]},{"cell_type":"markdown","metadata":{},"source":["<p>You create a <a href=\"http://watson-developer-cloud.github.io/python-sdk/v0.25.0/apis/watson_developer_cloud.speech_to_text_v1.html?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01\">Speech To Text Adapter object</a> the parameters are the endpoint and API key.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["authenticator = IAMAuthenticator(iam_apikey_s2t)\n","s2t = SpeechToTextV1(authenticator=authenticator)\n","s2t.set_service_url(url_s2t)\n","s2t"]},{"cell_type":"markdown","metadata":{},"source":["<p>Lets download the audio file that we will use to convert into text.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["!wget -O PolynomialRegressionandPipelines.mp3  https://cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud/IBMDeveloperSkillsNetwork-PY0101EN-SkillsNetwork/labs/Module%205/data/PolynomialRegressionandPipelines.mp3\n","\n"]},{"cell_type":"markdown","metadata":{},"source":["<p>We have the path of the .wav file we would like to convert to text</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["filename='PolynomialRegressionandPipelines.mp3'"]},{"cell_type":"markdown","metadata":{},"source":["<p>We create the file object <code>wav</code> with the wav file using <code>open</code>. We set the <code>mode</code> to  \"rb\" ,  this is similar to read mode, but it ensures the file is in binary mode. We use the method <code>recognize</code> to return the recognized text. The parameter <code>audio</code> is the file object <code>wav</code>, the parameter <code>content_type</code> is the format of the audio file.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["with open(filename, mode=\"rb\")  as wav:\n","    response = s2t.recognize(audio=wav, content_type='audio/mp3')"]},{"cell_type":"markdown","metadata":{},"source":["<p>The attribute result contains a dictionary that includes the translation:</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["response.result"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["from pandas import json_normalize\n","\n","json_normalize(response.result['results'],\"alternatives\")"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["response"]},{"cell_type":"markdown","metadata":{},"source":["<p>We can obtain the recognized text and assign it to the variable <code>recognized_text</code>:</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["recognized_text=response.result['results'][0][\"alternatives\"][0][\"transcript\"]\n","type(recognized_text)"]},{"cell_type":"markdown","metadata":{},"source":["<h2 id=\"ref1\">Language Translator</h2>\n"]},{"cell_type":"markdown","metadata":{},"source":["<p>First we import <code>LanguageTranslatorV3</code> from ibm_watson. For more information on the API click <a href=\"https://cloud.ibm.com/apidocs/speech-to-text?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01&code=python\"> here</a></p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["from ibm_watson import LanguageTranslatorV3"]},{"cell_type":"markdown","metadata":{},"source":["<p>The service endpoint is based on the location of the service instance, we store the information in the variable URL. To find out which URL to use, view the service credentials.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["url_lt=''"]},{"cell_type":"markdown","metadata":{},"source":["<p>You require an API key, and you can obtain the key on the <a href=\"https://cloud.ibm.com/resources?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01\">Dashboard</a>.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["apikey_lt=''"]},{"cell_type":"markdown","metadata":{},"source":["<p>API requests require a version parameter that takes a date in the format version=YYYY-MM-DD. This lab describes the current version of Language Translator, 2018-05-01</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["version_lt='2018-05-01'"]},{"cell_type":"markdown","metadata":{},"source":["<p>we create a  Language Translator object <code>language_translator</code>:</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["authenticator = IAMAuthenticator(apikey_lt)\n","language_translator = LanguageTranslatorV3(version=version_lt,authenticator=authenticator)\n","language_translator.set_service_url(url_lt)\n","language_translator"]},{"cell_type":"markdown","metadata":{},"source":["<p>We can get a Lists the languages that the service can identify.\n","The method Returns the language code.  For example English (en) to  Spanis (es) and name of each language.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["from pandas import json_normalize\n","\n","json_normalize(language_translator.list_identifiable_languages().get_result(), \"languages\")"]},{"cell_type":"markdown","metadata":{},"source":["<p>We can use the method <code>translate</code>. This will translate the text. The parameter text is the text, Model_id is the type of model we would like to use use we use list the language. In this case, we set it to 'en-es' or English to Spanish. We get a Detailed Response object translation_response</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["translation_response = language_translator.translate(\\\n","    text=recognized_text, model_id='en-es')\n","translation_response"]},{"cell_type":"markdown","metadata":{},"source":["<p>The result is a dictionary.</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{"jupyter":{"outputs_hidden":false}},"outputs":[],"source":["translation=translation_response.get_result()\n","translation"]},{"cell_type":"markdown","metadata":{},"source":["<p>We can obtain the actual translation as a string as follows:</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["spanish_translation =translation['translations'][0]['translation']\n","spanish_translation "]},{"cell_type":"markdown","metadata":{},"source":["<p>We can translate back to English</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["translation_new = language_translator.translate(text=spanish_translation ,model_id='es-en').get_result()"]},{"cell_type":"markdown","metadata":{},"source":["<p>We can obtain the actual translation as a string as follows:</p>\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["translation_eng=translation_new['translations'][0]['translation']\n","translation_eng"]},{"cell_type":"markdown","metadata":{},"source":["<br>\n"]},{"cell_type":"markdown","metadata":{},"source":["<h2>Quiz</h2>\n"]},{"cell_type":"markdown","metadata":{},"source":["Translate to French.\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["# Write your code below and press Shift+Enter to execute\n"]},{"cell_type":"markdown","metadata":{},"source":["<details><summary>Click here for the solution</summary>\n","\n","```python\n","French_translation=language_translator.translate(\n","    text=translation_eng , model_id='en-fr').get_result()\n","\n","French_translation['translations'][0]['translation']\n","\n","```\n","\n","</details>\n"]},{"cell_type":"markdown","metadata":{},"source":["<h3>Language Translator</h3>\n"]},{"cell_type":"markdown","metadata":{},"source":["<b>References</b>\n"]},{"cell_type":"markdown","metadata":{},"source":["[https://cloud.ibm.com/apidocs/speech-to-text?code=python](https://cloud.ibm.com/apidocs/speech-to-text?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01&code=python)\n"]},{"cell_type":"markdown","metadata":{},"source":["[https://cloud.ibm.com/apidocs/language-translator?code=python](https://cloud.ibm.com/apidocs/language-translator?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01&code=python)\n"]},{"cell_type":"markdown","metadata":{},"source":["<hr>\n"]},{"cell_type":"markdown","metadata":{},"source":["## Authors:\n","\n","[Joseph Santarcangelo](https://www.linkedin.com/in/joseph-s-50398b136/?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01)\n","\n","Joseph Santarcangelo has a PhD in Electrical Engineering, his research focused on using machine learning, signal processing, and computer vision to determine how videos impact human cognition. Joseph has been working for IBM since he completed his PhD.\n","\n","## Other Contributor(s)\n","\n","<a href=\"https://www.linkedin.com/in/fanjiang0619/?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkPY0101ENSkillsNetwork19487395-2021-01-01\">Fan Jiang</a>\n","\n","## Change Log\n","\n","| Date (YYYY-MM-DD) | Version | Changed By | Change Description                 |\n","| ----------------- | ------- | ---------- | ---------------------------------- |\n","| 2021-04-07        | 2.2     | Malika     | Updated the libraries              |\n","| 2021-01-05        | 2.1     | Malika     | Added a library                    |\n","| 2020-08-26        | 2.0     | Lavanya    | Moved lab to course repo in GitLab |\n","|                   |         |            |                                    |\n","|                   |         |            |                                    |\n","\n","<hr/>\n","\n","## <h3 align=\"center\"> © IBM Corporation 2020. All rights reserved. <h3/>\n"]}],"metadata":{"kernelspec":{"display_name":"Python 3","language":"python","name":"python3"},"language_info":{"codemirror_mode":{"name":"ipython","version":3},"file_extension":".py","mimetype":"text/x-python","name":"python","nbconvert_exporter":"python","pygments_lexer":"ipython3","version":"3.8.8"}},"nbformat":4,"nbformat_minor":4}